Docyt Panda On-Call CLI

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

Installation Location

When you run panda-oncall install, files are installed to:

• Commands: .cursor/commands/ in your workspace
• Skills: .cursor/skills/ in your workspace
• Rules: .cursor/rules/ in your workspace
• Manifest: .cursor/.panda-oncall-manifest.json (tracks versions)

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

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

Quick Start

Installation

# From within your project workspace (e.g., ~/Project/docyt/bb)
npx @docyt/panda-oncall-cli install

List Available Tools

npx @docyt/panda-oncall-cli list

Check for Updates

# Preview what would change
npx @docyt/panda-oncall-cli upgrade --preview

# Upgrade to latest version
npx @docyt/panda-oncall-cli upgrade

Show Differences

# Compare local vs latest versions
npx @docyt/panda-oncall-cli diff

Commands

install

Install Docyt development tools to your workspace.

# Install everything (default)
npx @docyt/panda-oncall-cli install

# Install only commands
npx @docyt/panda-oncall-cli install --commands

# Install only skills
npx @docyt/panda-oncall-cli install --skills

# Install only rules
npx @docyt/panda-oncall-cli install --rules

upgrade

Upgrade installed tools to the latest version.

# Preview changes without installing
npx @docyt/panda-oncall-cli upgrade --preview

# Upgrade (will prompt for local changes)
npx @docyt/panda-oncall-cli upgrade

# Force upgrade (overwrite all local changes)
npx @docyt/panda-oncall-cli upgrade --force

list

List all installed and available tools.

npx @docyt/panda-oncall-cli list

diff

Show differences between your local version and the latest available.

npx @docyt/panda-oncall-cli diff

What Gets Installed

Cursor Commands

Currently includes:

• docyt-panda-oncall-issues.md - Scan Slack channels for Team Panda on-call issues

More commands will be added over time.

Cursor Skills

Coming soon...

Cursor Rules

Coming soon...

How It Works

1. Detection: Automatically finds your workspace root by looking for .git or .cursor directories
2. Installation: Copies files from the CLI package to your workspace
3. Tracking: Creates a manifest file (.cursor/.docyt-oncall-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/.docyt-oncall-manifest.json to track:

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

Example manifest:

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

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
docyt-oncall 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 npx @docyt/panda-oncall-cli upgrade to get updates

Requirements

• Node.js >= 14.0.0
• Must be run from within a Git repository or Cursor workspace

License

ISC

Support

For issues or questions, contact Team Panda.