Projects and repositories

Projects are organization-scoped work containers. A Git repository points to one project through a committed .fp/config.toml file.

Inspect projects

$
fp2 project list --json
$
fp2 project show --id <project-id> --json

Bind a repository

Run from the repository root:

$
fp2 init --project <PROJECT_KEY> --json
$
fp2 status --json

The binding contains only:

• the opaque project ID;
• the display prefix used for issue references.

It contains no API key and no local profile name, so it is safe to commit.

If the repository is already bound to the same project, fp2 init succeeds without changing it. If it points elsewhere, stop instead of silently replacing the binding.

Create a project

Create a project only when a human explicitly supplies the key and name:

$
fp2 project create \
>
  --key <ONE_TO_SIX_UPPERCASE_LETTERS> \
>
  --name "<human-readable-name>" \
>
  --client-id "<stable-retry-id>" \
>
  --json

Choose client_id before the first request. If the result is uncertain, retry with the same ID and identical payload.