Installation

Quick Install

Install fp with a single command:

curl -fsSL https://setup.fp.dev/install.sh | sh -s

This downloads the latest fp binary for your platform and adds it to your path.

Requirements

• macOS (Apple Silicon or Intel) or Linux (x86_64)
• Git — fp tracks commits alongside issues
• Claude Code — for agent-driven workflows (optional but recommended)

Verify Installation

fp --version

Initialize a Project

Navigate to your project directory and run:

cd your-project
fp init

fp init creates a .fp/ directory with project configuration and offers to run fp setup claude for Claude Code integration.

For non-interactive setup (CI, scripts):

fp init --prefix FP --yes

Configure Claude Code Integration

Claude integration is managed directly by fp — no marketplace plugin required:

fp setup claude

This sets up:

• Skills in .claude/skills/ for planning, implementing, and reviewing
• Hook in .claude/settings.local.json for automatic issue detection
• FP_CLAUDE.md with workflow instructions for the agent
• CLAUDE.md reference to @FP_CLAUDE.md

For non-interactive setup:

fp setup claude --yes

What Gets Created

your-project/
├── FP_CLAUDE.md              # Agent workflow instructions
├── CLAUDE.md                 # Updated with @FP_CLAUDE.md reference
└── .fp/
    ├── config.toml           # Project config (issue prefix, etc.)
    └── integrations.json     # Integration state and managed resources

Issue data is stored globally at ~/.fiberplane/projects/<project-name>/.

Next Steps

Head to the Quick Start to create your first issues and learn the fp workflow.