Agent-native issue tracking for ambitious Claude Code users.
fp.dev · Docs
fp is a CLI-first issue tracker designed for AI agents. It lives in your terminal, stores everything locally, and gives agents the focused context they need to ship code across sessions.
This is the public repository for fp. The source code is private (for now). This repo is for:
- Filing issues — bug reports, feature requests, and feedback
- Extension examples — reference implementations for fp's extension system
- Community discussion — via GitHub Issues and Discussions
curl -fsSL https://setup.fp.dev/install.sh | sh -s
cd your-project
fp initSee the docs for full setup and usage.
fp supports extensions that hook into issue lifecycle events. The extensions/ directory contains example extensions ranging from beginner to advanced:
| Example | Complexity | What it does |
|---|---|---|
hello-hooks |
Beginner | Logs issue events — the smallest useful extension |
status-transition-guard |
Beginner | Blocks invalid status transitions |
issue-template-enforcer |
Beginner | Blocks issues missing required sections |
post-create-automation |
Beginner | Posts welcome comments, creates follow-up issues |
custom-properties |
Beginner | Registers custom issue properties (select, text, etc.) |
quality-gate |
Intermediate | Runs tests/lint before allowing "done" transition |
backlog-researcher |
Intermediate | Spawns Claude to research new issues |
jj-workspace |
Advanced | Manages jj workspaces tied to issue lifecycle |
cursor-agent |
Advanced | Dispatches issues to a Cursor agent with polling |
Start with hello-hooks and work your way up. Each example has its own README.
Please open an issue with steps to reproduce.
The extension examples in this repository are released under the MIT License. fp itself is proprietary software — see fp.dev for details.