Get started

Install, configure, and master the fp CLI

Everything you need to track feature parity, in one place. Install the CLI, point it at your environment, then learn the core concepts and full command reference — no jumping between pages.

Install the fp CLI

Pick one of these options — they both install the same CLI. Requires Ruby 3.0+.

One-line installer script

Checks for Ruby, installs the gem, and verifies the binary is on your PATH.

curl -fsSL https://api.featureparity.dev/api/cli/install | bash

Already have fp? Run fp update to get the latest version. See update instructions.

Requirements

Ruby 3.0+

macOS: brew install ruby
Ubuntu: sudo apt install ruby-full

Network access

The CLI calls the FeatureParity API (defaults to api.featureparity.dev).

API key

Generate one under Account → Agents & API keys. Starts with fp_.

Update the CLI

fp doctor shows the newest version, and fp tells you, at most once a day, when the one you have is behind.

fp update

The changelog lists what changed in every release.

That command arrived in fp 0.0.34. If yours answers Unknown command: update, it is 0.0.33 or older: update the gem directly, or run the installer script again. Both do the same thing.

gem update featureparity

Then refresh what fp wrote into each repo that uses it:

fp skill install fp init --force

The first replaces the agent skill, if the repo has it. The second rewrites the FeatureParity section of AGENTS.md.

For AI agents

Teach your coding agent to use fp with the Agent Skills package — one install works across Claude Code, Codex, Cursor, Gemini CLI, Kiro, Copilot, and more.

fp skill install

The skill ships inside the fp gem. This copies it into the repo's .claude/skills (Claude Code) and .agents/skills (Codex, Cursor, Gemini CLI and others), or your home directory with --global, so your agent knows how to add fp:<slug> markers, report evidence (including from JUnit reports), and propose requirements — no hand-holding required. Re-run it after upgrading the gem.

Working in one repository? fp init --project <slug> writes the skill's core guidance into the repo's AGENTS.md (or its CLAUDE.md, if that's what the repo has), so an agent that reads it needs no skill install.

Installed? Next,

Ready to start?

Install the CLI, mint an API key, and watch your parity matrix fill up.