Docyt Panda CLI

A CLI tool for installing and managing Docyt Team Panda development tools, including Cursor commands, skills, and rules.

Quick Start

Install Globally (Recommended)

npm install -g @docyt/panda-cli

Now you can run panda-cli from anywhere!

Usage

# Go to your project
cd ~/Project/docyt/bb

# Install to current directory
panda-cli install

That's it! The command will be installed to .cursor/commands/ in your current directory.

Installation Location

Files are installed to your current directory (or specified path):

• Commands: [current-dir]/.cursor/commands/
• Skills: [current-dir]/.cursor/skills/
• Rules: [current-dir]/.cursor/rules/
• Manifest: [current-dir]/.cursor/.panda-cli-manifest.json

Example: If you run from /Users/sheng/Project/docyt/bb:

/Users/sheng/Project/docyt/bb/.cursor/commands/panda-oncall-state.md

Commands

install - Install Tools

# Install to current directory
panda-cli install

# Install to specific directory
panda-cli install /path/to/project

# Install only commands
panda-cli install --commands

# Install only skills
panda-cli install --skills

# Install only rules
panda-cli install --rules

# Install everything (default)
panda-cli install --all

list - List Tools

List all installed and available tools.

panda-cli list

upgrade - Upgrade Tools

Upgrade installed tools to the latest version.

# Preview changes without installing
panda-cli upgrade --preview

# Upgrade (will prompt for local changes)
panda-cli upgrade

# Force upgrade (overwrite all local changes)
panda-cli upgrade --force

diff - Show Differences

Show differences between your local version and the latest available.

panda-cli diff

What Gets Installed

Cursor Commands

Currently includes:

• panda-oncall-state.md - Scan Slack channels for Team Panda on-call issues and Rollbar errors, post comprehensive report to #panda-oncall
• panda-explain-feature.md - Investigate and explain Docyt business features with code-backed accuracy
• panda-fix-rollbar.md - NEW - Investigate Rollbar error, create Jira ticket with AI-generated implementation plan

More commands will be added over time.

Cursor Skills

Coming soon...

Cursor Rules

Coming soon...

How It Works

1. Simple Detection: Uses current directory (or specified path)
2. Installation: Copies files from the CLI package to your workspace
3. Tracking: Creates a manifest file (.cursor/.panda-cli-manifest.json) to track versions
4. Smart Upgrades: Detects local changes and prompts before overwriting

Manifest File

The CLI creates a manifest file at .cursor/.panda-cli-manifest.json to track:

• Installed version
• Installation/upgrade timestamps
• List of installed assets
• Local customizations

Example manifest:

{
  "version": "0.1.1",
  "installed": "2026-02-01T08:00:00Z",
  "assets": {
    "commands": ["docyt-panda-oncall-issues.md"],
    "skills": [],
    "rules": []
  },
  "customizations": {}
}

Alternative: Use with npx (No Install)

You can also use the CLI without installing globally:

# Install to current directory
npx @docyt/panda-cli install

# List tools
npx @docyt/panda-cli list

# Upgrade
npx @docyt/panda-cli upgrade

Note: npx runs slower than global install because it downloads each time.

Development

Local Development

# Install dependencies
cd docyt-panda-oncall-cli
npm install

# Make CLI available globally for testing
npm link

# Now you can run it from anywhere
panda-cli list

Publishing Updates

# Bump version
npm version patch  # or minor, major

# Publish to npm
npm publish --access public

Adding New Assets

1. Add files to assets/commands/, assets/skills/, or assets/rules/
2. Bump the version in package.json
3. Publish to npm
4. Users run panda-cli upgrade to get updates

Requirements

• Node.js >= 14.0.0

License

ISC

Support

For issues or questions, contact Team Panda.