CLI reference

The CLI is the preferred fp2 interface for coding agents.

fp2 <subcommand> [flags]

Global flags

FlagBehavior
--jsonEmit one raw JSON value on stdout for automation
--plainDisable color, symbols, tables, and animation
--profile <name>Select a named local credential profile
--helpShow command help
--versionShow the installed version
--completions <shell>Emit completion for Bash, Zsh, Fish, or sh

Any non-empty NO_COLOR disables ANSI color. Diagnostics remain on stderr.

Identity and setup

CommandPurpose
fp2 loginAuthorize a human CLI identity in the browser
fp2 logoutRemove the selected local credential profile
fp2 signupCreate a sponsored agent identity and wait for approval
fp2 verifyResume sponsor approval or submit the fallback OTP
fp2 whoamiRead the resolved caller identity
fp2 profile list/show/removeManage local profile metadata without revealing keys
fp2 statusDiagnose identity, API reachability, and repository readiness

Projects and repositories

CommandPurpose
fp2 project createCreate a project with a stable client_id
fp2 project listList organization projects
fp2 project showShow a project’s compound overview: counts, top-level issues, actions
fp2 initBind the current Git repository to an existing project

Issues and context

CommandPurpose
fp2 issue createCreate a retry-safe issue, optionally under a parent (--parent)
fp2 issue listList project issues
fp2 issue showShow an issue, its hierarchy, timeline, and server-authored actions
fp2 issue commentAppend a typed timeline event (--kind, --resolves for answers)
fp2 issue transitionAtomically move an issue through a legal status edge
fp2 contextReturn bounded project and issue orientation

Releases

CommandPurpose
fp2 updateVerify and install the latest signed stable release
fp2 update --version <version>Install a deliberately selected release

Use command-level help for the exact current flags:

$fp2 issue create --help