CLI reference

briar agent

Run an autonomous LLM tool-use loop against a target. Two operations ship: implement (the engineer archetype — pick a ticket, write the code, open a PR) and prfix (the pr-fixer archetype — read PR review comments, push fixes, reply).

Flags common to both subcommands

Both implement and prfix share a large set of flags. Documented once here, elided from each subcommand below.

--company COMPANYrequired

Company key. Must match a runbook YAML if you pass --runbook.

--owner OWNERrequired

Repository owner (GitHub) or workspace (Bitbucket).

--repo REPOrequired

Repository name / slug.

--provider {bitbucket,github}default: github

bitbucketgithub

Repository provider.

--store {file,postgres}default: postgres

filepostgres

Knowledge-store backend used to read the company knowledge blob.

--knowledge PATHdefault: ./knowledge

File-store root (ignored for postgres).

--model MODEL

Override the LLM provider's default model.

--max-iter N

Iteration ceiling. Defaults to AgentRunner.DEFAULT_MAX_ITERATIONS (30).

--git-user-name NAME

git config user.name on the worktree. Required unless company.git_identity.name is set in the runbook.

--git-user-email EMAIL

git config user.email. Same fallback rule.

--keep-worktree

Leave the temp worktree in /tmp after the run for inspection.

--dry-run

Build + print the system prompt, user message, and tool list. Skip the LLM call. Validates the JIT context wiring without spending tokens.

--runbook YAML

Runbook YAML to read this company's messages: block from. When set, the agent gets a send_message tool bound to the configured channels instead of having to shell out via gh / curl.

--meeting PROVIDERdefault: fireflies

fireflies

Meeting provider for transcript fetch.

--meeting-key ID

Specific meeting ID to splice into the agent prompt.

--meeting-query STRING

Keyword search across recent meetings. When omitted, defaults to the ticket key (for implement) or owner/repo#pr (for prfix).

--meeting-top-k Ndefault: 3

Max meetings to fetch in search mode.

--meeting-max-bytes Ndefault: 50000

Per-meeting transcript byte cap.

$ briar agent implement

briar agent implement --company C --owner O --repo R
                      --ticket-project P --ticket-key K
                      [--tracker {...}] [common flags]

Pick a tracker ticket, clone the repo into a temp worktree, run the engineer archetype until it opens a PR. Reads the company knowledge blob + a JIT ticket-context extractor for live ticket detail.

--ticket-project KEYrequired

Tracker project key. Jira: PROJ; Linear team: ENG; GH / BB Issues: owner/repo.

--ticket-key KEYrequired

Ticket identifier. Jira: PROJ-123; GH / BB: #42; Linear: ENG-7.

--tracker {bitbucket-issues,github-issues,jira,linear}default: jira

bitbucket-issuesgithub-issuesjiralinear

Tracker provider for the ticket.

$ briar agent implement \
    --company acme --owner acme --repo widgets \
    --tracker jira --ticket-project KAN --ticket-key KAN-42 \
    --runbook runbooks/acme.yaml

$ briar agent prfix

briar agent prfix --company C --owner O --repo R
                  --pr N --branch BRANCH [common flags]

Read open review comments on a PR, apply fixes, push the branch, and reply inline. Reads the company knowledge blob + a JIT pr-review-context extractor for the full review thread state.

--pr NUMBERrequired

PR number to address.

--branch BRANCHrequired

PR head branch name. Required because some providers don't expose it cheaply.

$ briar agent prfix \
    --company acme --owner acme --repo widgets \
    --pr 482 --branch briar/kan-42 \
    --runbook runbooks/acme.yaml

Run prfix from cron

prfix is idempotent — replies to comments it already handled are skipped. Wire it to a schedule_cron trigger or a webhook and it will keep PRs unblocked without supervision.

Flags common to both subcommands

$ briar agent implement

$ briar agent prfix

See also