Agent Integration

Pad is built from the ground up to work with AI coding agents. The /pad skill lets your agent manage your project through natural conversation — and it works with any major AI coding tool.

Installing the Skill

pad agent install              # Auto-detect your tools and install
pad agent install claude       # Claude Code
pad agent install cursor       # Cursor (also covers Codex & Windsurf)
pad agent install codex        # OpenAI Codex
pad agent install windsurf     # Windsurf
pad agent install copilot      # GitHub Copilot
pad agent install amazon-q     # Amazon Q Developer
pad agent install junie        # JetBrains Junie

pad agent install with no arguments scans your project for tool directories (.claude/, .cursor/, .github/, etc.) and installs the skill for each detected tool.

Supported Tools

Tool	Skill Location	Notes
Claude Code	`.claude/skills/pad/SKILL.md`	Full skill with allowed-tools
Cursor	`.agents/skills/pad/SKILL.md`	Shared with Codex & Windsurf
OpenAI Codex	`.agents/skills/pad/SKILL.md`	Shared with Cursor & Windsurf
Windsurf	`.agents/skills/pad/SKILL.md`	Shared with Cursor & Codex
GitHub Copilot	`.github/instructions/pad.instructions.md`	Uses `applyTo` frontmatter
Amazon Q	`.amazonq/rules/pad.md`	Plain markdown
JetBrains Junie	`.junie/guidelines/pad.md`	Plain markdown

Tip: Cursor, Codex, and Windsurf all share the .agents/skills/ directory. One install covers all three.

Managing Installations

pad agent status         # See supported tools and installation status
pad agent update         # Update all installed tool integrations
pad agent install --all  # Install for all detected tools

The `/pad` Skill

Once installed, just talk to your project:

/pad what should I work on next?
/pad create a task for fixing the auth bug
/pad mark the OAuth fix as done
/pad let's create a plan for v0.2
/pad how are we doing on the MVP?
/pad I have an idea for real-time sync

How It Works

The agent loads your workspace context (pad project dashboard, pad collection list)
It interprets your natural language request
It maps your intent to CLI commands
It executes the commands and presents results conversationally
It always confirms before creating or modifying items

Conventions

Conventions are project-specific rules that AI agents follow automatically. They’re stored as items in the Conventions collection.

pad item create convention "Run tests before completing tasks" 
  --field trigger=on-task-complete 
  --field scope=all 
  --field priority=must 
  --content "Always run the test suite before marking a task as done. Fix any failures before completing."

Convention Fields

Field	Options	Description
trigger	`always`, `on-task-start`, `on-task-complete`, `on-implement`, `on-commit`, `on-pr-create`, `on-plan`	When the convention applies
scope	`all`, `backend`, `frontend`, `mobile`, `docs`, `devops`	What part of the project it covers
priority	`must`, `should`, `nice-to-have`	How strictly it should be followed

How Agents Use Conventions

Before performing any action, the agent loads relevant conventions:

Starting implementation → loads on-implement conventions
Completing a task → loads on-task-complete conventions
Creating a PR → loads on-pr-create conventions
always conventions are loaded on every /pad invocation

The agent treats must conventions as hard rules and should conventions as strong guidelines.

Playbooks

Playbooks are multi-step workflows for specific actions. They’re like conventions but with ordered steps.

pad item create playbook "Implementation Workflow" 
  --field trigger=on-implement 
  --field scope=all 
  --stdin <<'EOF'
1. Read the task description and acceptance criteria
2. Check for related items using wiki links
3. Create a feature branch
4. Implement the change
5. Run tests: `make test`
6. Run the build: `make build`
7. Update the task status to done
EOF

When an agent encounters a playbook matching its current action, it follows the steps in order.

Teaching Your Agent

When your AI agent does something you want to correct or standardize, you can save it as a convention:

/pad save a convention: always use conventional commit messages

The agent will create a convention with an appropriate trigger and scope, so all future interactions follow the rule.

Machine-Readable Output

All CLI commands support --format json for agent consumption:

pad project dashboard --format json
pad item list tasks --format json
pad item show fix-oauth --format json

This makes it easy for agents to parse structured data rather than scraping table output.