CLI Command Reference

This page covers the Sigilix CLI — the sigilix binary you run in your terminal. For the @sigilix / /sigilix commands you type on a PR comment, see Slash Commands; those run on the hosted GitHub App, while the commands here run locally and reach for the same earned-context layer.

The Sigilix CLI is included with your plan — sign up free or start a 14-day Pro trial to use it. Run sigilix --help and sigilix <command> --help for the authoritative list on your installed version.

Command overview

Command	What it does
`sigilix`	Opens the interactive terminal UI — chat with the grounded agent in your repo
`sigilix run [message..]`	Runs the agent non-interactively with a message
`sigilix review [target]`	Reviews changes — uncommitted by default, or a branch / commit / PR URL
`sigilix login`	Signs in to Sigilix (opens your browser)
`sigilix whoami`	Shows the signed-in user, plan, and entitlements
`sigilix logout`	Signs out (clears the stored key on this device)
`sigilix providers`	Manages AI providers and credentials (alias: `sigilix auth`)
`sigilix models [provider]`	Lists the models available to your account
`sigilix update`	Updates the CLI to the latest version
`sigilix --help`	Lists available commands and global flags

`sigilix` (interactive)

Running sigilix with no arguments opens the interactive terminal UI in the current directory. This is the chat surface: ask questions about the repo, drive changes, or interrogate past findings — the agent is grounded in the earned-context layer on every turn. See Deep-Research Chat.

# Open the interactive UI in the current repo
sigilix

`sigilix review`

Reviews changes. With no target it reviews your uncommitted changes — staged, unstaged, and untracked files. Pass a branch name, a commit hash, or a PR URL to review that instead. The reviewer reads the full files being modified (not just the diff hunks) and judges the change in the context of the repository.

# Review your uncommitted changes
sigilix review
 
# Review the current branch against another branch
sigilix review main
 
# Review a single commit
sigilix review 4f2c9ab
 
# Review a pull request
sigilix review https://github.com/acme/api/pull/214

What the output looks like

A summary followed by findings anchored to files and lines, tagged by severity and proof tier. See Sigilix CLI for a worked example.

`sigilix run`

Runs the agent non-interactively with a message — useful for one-shot tasks and scripting.

# One-shot question or task
sigilix run "why did the order-total finding fire on the refunds PR?"
 
# Continue the most recent session
sigilix run --continue "now fix it"

Representative flags

--continue — continue the last session instead of starting fresh.
--session <id> — continue a specific session.
--model <provider/model> — pick the model for this run.
--agent <name> — run a specific agent.
--format json — machine-readable output instead of the default rendering.
--dir <path> — run against a different directory.

Run sigilix run --help for the full list.

`sigilix login` / `whoami` / `logout`

Authenticates the CLI to your Sigilix account. sigilix login opens your browser to app.sigilix.ai; approve the request and the CLI stores a per-user API key for this device. The default API host is api.sigilix.ai — no environment variables needed.

sigilix login    # opens your browser and authorizes this device
sigilix whoami   # shows your login, plan, and entitlements
sigilix logout   # clears the stored key on this device

What whoami shows

sigilix whoami re-checks your account and prints your login, your plan, and whether paid-tier entitlements — like bring-your-own model keys — are enabled. If the check can’t reach the server, it shows the cached plan and marks it as offline rather than guessing.

Signing out

sigilix logout clears the credential stored on this device. To revoke the key server-side, use your account settings at app.sigilix.ai.

`sigilix providers`

Manages AI providers and credentials (alias: sigilix auth). This is where you connect your own provider key on paid tiers — see Bring Your Own Key.

sigilix providers list     # show configured providers
sigilix providers login    # connect a provider with your own key (paid tiers)
sigilix providers logout   # disconnect a provider

Sigilix account authentication (sigilix login) and provider credentials (sigilix providers) are separate. The hosted Sigilix models work with just your account; connecting any other provider’s key is a paid-tier entitlement, checked against your plan before a key is accepted.

`sigilix models`

Lists the models available to your account — the hosted Sigilix lineup plus any providers you’ve connected.

sigilix models             # all available models
sigilix models <provider>  # models for one provider

See The Sigilix Models for the hosted lineup.

Housekeeping

sigilix update       # update the CLI to the latest version
sigilix uninstall    # remove the CLI from this machine
sigilix completion   # generate a shell completion script

Global flags: --help / -h, --version / -v, --print-logs, --log-level DEBUG|INFO|WARN|ERROR.

CLI Command Reference

Command overview

sigilix (interactive)

sigilix review

sigilix run

sigilix login / whoami / logout

sigilix providers

sigilix models