## Quick Install

Install fp with a single command:

```bash
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

```bash
fp --version
```

## Initialize a Project

Navigate to your project directory and run:

```bash
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):

```bash
fp init --prefix FP --yes
```

## Configure Claude Code Integration

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

```bash
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:

```bash
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](/docs/getting-started/quick-start) to create your first issues and learn the fp workflow.