@getpawl/setup

Pawl is the coordination layer for AI-native development. It sits between you and your AI coding agents — tracking what was planned, what was built, what drifted, and what needs your attention.

Dashboard: app.getpawl.dev · Site: getpawl.dev

Quick Start

cd your-project
npm install -g @getpawl/setup
pawl init

That's it. Pawl detects your agents, installs hooks, connects to your dashboard, and syncs automatically after each session.

What Pawl does

After every Claude Code session, Pawl:

• Parses what the agent built, decided, and changed
• Matches changes to your specs and flags divergences
• Creates a review queue of items that need your attention
• Updates your session brief so the next session starts with full context

Everything is visible at app.getpawl.dev.

Commands

pawl init          # Set up Pawl in this repo
pawl sync          # Push current session to dashboard
pawl sync --pull   # Pull latest context before starting work
pawl status        # Check connection and hook health
pawl migrate       # Migrate from an older Pawl version

Sync runs automatically via hooks after every commit. Use pawl sync manually when needed.

Supported agents

| Agent | Hook method | |-------|-------------| | Claude Code | .claude/settings.json lifecycle hooks | | Codex | AGENTS.md instructions + git post-commit hook | | Gemini CLI | .gemini/settings.json lifecycle hooks | | Cursor | .cursor/rules + git post-commit hook |

Joining an existing Pawl project

If someone on your team already uses Pawl:

1. Clone the repo
2. Run pawl init — it detects existing specs and skips bootstrap automatically
3. Get your API key from app.getpawl.dev → Settings
4. Run pawl status to confirm everything is connected

Requirements

• Node.js >= 18
• Git repository

Windows users: Pawl works natively on Windows. WSL is not required.

License

MIT