Command reference
Generated from fiber help. Do not edit by hand; run FIBER_UPDATE_COMMANDS=1 cargo nextest run -p main --bins command_reference to regenerate.
fiber
Fiber, a coding agent.
Usage: fiber <command> [arguments]
Sessions:
fiber [--model <model>] [-c <key>=<value>]... Open the terminal
ask [--model <model>] [-c <key>=<value>]... [--resume <id> [--credential <label>]] [--worktree] [<prompt>] [-] Run one session of one turn; its events go to stdout
resume [<id>] [--credential <label>] Open a session in the terminal, or home at the session list
continue [--hub <name>] Open the most recent session in this project
sessions [--all] [--archived] [--json] List sessions: id, state, name, what it waits on, spend
sessions search [--all] [--json] <text> Search the logs of past and running sessions for the text
sessions delete [--hub <name>] [--cascade] [--yes] <id> Delete a session, and with --cascade the sessions that continue it
sessions archive [--hub <name>] <id> Archive a session: it leaves the list and the home rail
sessions export <id> [<path>] Write the session's log and its artifacts to <path>
sessions prune [--hub <name>] [--older-than <duration>] [--cascade] [--force] [--dry-run] [--yes] Delete old sessions, worktrees and diagnostic logs
models [<search>] [--json] List the models the installed providers serve
reviewer evidence --json Print the evidence behind the reviewer's notes as JSON
Fiber itself:
setup [--provider <name>]... [--model <model>] [--thinking <level>] [--import <claude-code | codex>]... [--completions <shell> | --no-completions] [--hub | --no-hub] Ask the questions a new install needs, applying each answer
update Update the Fiber binary and every installed extension together; `upgrade` runs the same command, with `--channel stable|nightly`
approve [--yes] Show what this repository ships and approve it
login [<name>] [--as <label>] [--device] Store a provider's key or an extension's secret
logout <provider> [--as <label> | --all] Delete a provider's stored key
doctor Says whether a session can start, and how to fix it when it cannot
stop [--hub <name>] Shut down every running session, then the hub
feedback [<prompt>] [-] [--session <id>] Write a feedback report and print the issue link.
completion <shell> Print a completion script for bash, zsh or fish
help [<command>] Print this menu, or a command's help
version Print the version
Extensions:
extension install [--project] <name or path> Install an extension and its dependencies
extension update [<name>] Update one extension, or every installed extension, to its newest tag
extension remove <name> Remove an extension, the dependencies nothing else uses, and their data
extension reinstall <name> Remove an extension and install it again from its recorded source and commit
extension list List installed extensions: name, version and commit
extension test [<path>] Run an extension's test cases against the scripted provider
MCP servers:
mcp add [--project | --repo] <name> <url> Declare a remote server
mcp add [--project | --repo] <name> [-e KEY=value]... [--secret KEY]... -- <command> [args]... Declare a stdio server
mcp remove [--project | --repo] <name> Remove a server's declaration
mcp list List declared servers, their layers and approvals
mcp login <server> Log in to a server that needs OAuth
mcp logout <server> Delete a server's stored token
Configuration:
config get <key> Print the effective value and the layer it came from
config set [--project | --repo] <key> <value> Write one key in one layer's file
import <claude-code | codex> Copy another harness's configuration into Fiber home, once
The hub:
hub add [--default] <name> <address> Add a hub to this client's list
hub remove <name> Remove a hub from this client's list
hub install [--port <port>] Register the hub as a login service
hub uninstall Remove the hub's login service; running sessions carry on
hub status [--json] Print the hub's state: running, version, port, clients, devices, installed
hub refresh Rebuild the hub's environment for the sessions it starts from now on
hub pair <device> [--address <url>] Print a pairing code for a device of that name
hub token list List paired devices: name, when paired, last connection
hub token revoke <device> Revoke a device's token and close its live connections
Flags:
-h, --help Print this menu
-v, --version Print the version
Examples:
fiber ask "review the diff on this branch"
fiber ask < brief.md
git diff | fiber ask "review this diff" -
fiber extension install openrouter
fiber login openrouter
fiber help ask
fiber update
Update the Fiber binary and every installed extension together; `upgrade` runs the same command
Usage: fiber update [OPTIONS]
Options:
--channel <channel> The release channel: `stable` or `nightly`. Absent reads `FIBER_CHANNEL`; an empty or unset variable means stable [possible values: stable, nightly]
-h, --help Print help
fiber ask
Run one session of one turn; its events go to stdout
Usage: fiber ask [OPTIONS] [prompt]...
Arguments:
[prompt]... The prompt. A final `-` reads stdin
Options:
--model <model> The model for this run, as a person types it
-c <key>=<value> One configuration key for this run, `<key>=<value>`: the value is JSON, or a bare string when it does not parse as JSON. May repeat; a later one wins, and every one wins over `--model`
--resume <id> Resume the session: sends the prompt to an existing session instead of starting a new one (`docs/invocation.md`, "Lifecycle")
--credential <label> On a resume, the credential label to switch the session to
--worktree Run the session in a new worktree (`docs/invocation.md`, "Isolation")
-h, --help Print help
fiber resume
Open a session in the terminal, or home at the session list
Usage: fiber resume [OPTIONS] [id]
Arguments:
[id] The session: a full id or a unique prefix of one. With none, home opens at the session list
Options:
--credential <label> The credential label to switch the session to (`docs/model-routing.md`, "Which credential a session uses")
--hub <name> Use a hub from this client's list
-h, --help Print help
fiber continue
Open the most recent session in this project
Usage: fiber continue [OPTIONS]
Options:
--hub <name> Use a hub from this client's list
-h, --help Print help
fiber sessions
List sessions, or delete, export or prune them
Usage: fiber sessions [OPTIONS]
fiber sessions <COMMAND>
Commands:
archive Archive a session: it leaves the list and the home rail
delete Delete a session, and with --cascade the sessions that continue it
export Write the session's log and its artifacts to <path>
prune Delete old sessions, worktrees and diagnostic logs
search Search the logs of past and running sessions for the text
Options:
--hub <name> Use a hub from this client's list
--all List every project, not only this repository's
--json Print each session as one JSON object per line
--archived List archived sessions instead of live and exited ones
-h, --help Print help
fiber sessions archive
Archive a session: it leaves the list and the home rail
Usage: fiber sessions archive [OPTIONS] <id>
Arguments:
<id> The session: a full id or a unique prefix of one
Options:
--hub <name> Use a hub from this client's list
-h, --help Print help
fiber sessions delete
Delete a session, and with --cascade the sessions that continue it
Usage: fiber sessions delete [OPTIONS] <id>
Arguments:
<id> The session: a full id or a unique prefix of one
Options:
--hub <name> Use a hub from this client's list
--cascade Also delete every session that continues it: its forks and rewinds, and theirs
--yes Delete without asking
-h, --help Print help
fiber sessions export
Write the session's log and its artifacts to <path>
Usage: fiber sessions export <id> [path]
Arguments:
<id> The session: a full id or a unique prefix of one
[path] The directory to write, from the current directory when relative; the session id when absent
Options:
-h, --help Print help
fiber sessions prune
Delete old sessions, worktrees and diagnostic logs
Usage: fiber sessions prune [OPTIONS]
Options:
--hub <name> Use a hub from this client's list
--older-than <duration> Delete every exited session whose last line is older than this, such as `30d`: a whole number and `s`, `m`, `h` or `d`. Without it no session is deleted
--cascade Also delete every session that continues a deleted one
--dry-run Print what would be deleted and the space it would free, and delete nothing
--yes Prune without asking
--force Remove a worktree even when removing it would lose something. A worktree a running session works in is never removed
-h, --help Print help
fiber sessions search
Search the logs of past and running sessions for the text
Usage: fiber sessions search [OPTIONS] <text>
Arguments:
<text> The text to find, as a literal
Options:
--all Search every project, not only this repository's
--json Print each hit as one JSON object per line
-h, --help Print help
fiber reviewer
Show the evidence behind the reviewer's notes
Usage: fiber reviewer <COMMAND>
Commands:
evidence Print each topic's evidence as one JSON object keyed by topic
Options:
-h, --help Print help
fiber reviewer evidence
Print each topic's evidence as one JSON object keyed by topic
Usage: fiber reviewer evidence --json
Options:
--json Print the evidence as JSON
-h, --help Print help
fiber models
List the models the installed providers serve
Usage: fiber models [OPTIONS] [search]
Arguments:
[search] Only list models whose `provider/model` holds this text
Options:
--json Print one JSON object per model
-h, --help Print help
fiber extension
Manage extensions
Usage: fiber extension <COMMAND>
Commands:
install Install an extension and its dependencies
update Update one extension, or every installed extension, to its newest tag
remove Remove an extension, the dependencies nothing else uses, and their data
reinstall Remove an extension and install it again from its recorded source and commit
list List installed extensions: name, version and commit
test Run an extension's test cases against the scripted provider
Options:
-h, --help Print help
fiber extension install
Install an extension and its dependencies
Usage: fiber extension install [OPTIONS] <name or path>
Arguments:
<name or path> The extension's name, or a path to its package
Options:
--project Enable the extension only for the current project
-h, --help Print help
fiber extension update
Update one extension, or every installed extension, to its newest tag
Usage: fiber extension update [name]
Arguments:
[name] The installed extension's name
Options:
-h, --help Print help
fiber extension remove
Remove an extension, the dependencies nothing else uses, and their data
Usage: fiber extension remove <name>
Arguments:
<name> The installed extension's name
Options:
-h, --help Print help
fiber extension reinstall
Remove an extension and install it again from its recorded source and commit
Usage: fiber extension reinstall <name>
Arguments:
<name> The installed extension's name
Options:
-h, --help Print help
fiber extension list
List installed extensions: name, version and commit
Usage: fiber extension list
Options:
-h, --help Print help
fiber extension test
Run an extension's test cases against the scripted provider
Usage: fiber extension test [path]
Arguments:
[path] The extension package; defaults to the current directory
Options:
-h, --help Print help
fiber mcp
Manage MCP servers
Usage: fiber mcp <COMMAND>
Commands:
add Declare a remote or stdio server
remove Remove a server's declaration
list List declared servers, their layers and approvals
login Log in to a server that needs OAuth
logout Delete a server's stored token
Options:
-h, --help Print help
fiber mcp add
Declare a remote or stdio server
Usage: fiber mcp add [OPTIONS] <name> [url] [-- <command>...]
Arguments:
<name> The server's name
[url] The server's URL: a remote server. With none, `-- <command>` declares a stdio server
[command]... The program and its arguments: a stdio server
Options:
--project Write the per-project file in Fiber home
--repo Write the repository's `.fiber/config.json`
-e <KEY=value> A clear variable, `KEY=value`; only with `-- <command>`. May repeat
--secret <KEY> A secret variable's name, stored beside the configuration; only with `-- <command>`. May repeat
-h, --help Print help
fiber mcp remove
Remove a server's declaration
Usage: fiber mcp remove [OPTIONS] <name>
Arguments:
<name> The server's name
Options:
--project Remove from the per-project file in Fiber home
--repo Remove from the repository's `.fiber/config.json`
-h, --help Print help
fiber mcp list
List declared servers, their layers and approvals
Usage: fiber mcp list
Options:
-h, --help Print help
fiber mcp login
Log in to a server that needs OAuth
Usage: fiber mcp login <server>
Arguments:
<server> The server's name
Options:
-h, --help Print help
fiber mcp logout
Delete a server's stored token
Usage: fiber mcp logout <server>
Arguments:
<server> The server's name
Options:
-h, --help Print help
fiber approve
Show what this repository ships and approve it
Usage: fiber approve [OPTIONS]
Options:
--yes Approve without asking, for a script or a machine image
-h, --help Print help
fiber config
Print a configuration value, or write one
Usage: fiber config <COMMAND>
Commands:
get Print the effective value and the layer it came from
set Write one key in one layer's file
Options:
-h, --help Print help
fiber config get
Print the effective value and the layer it came from
Usage: fiber config get <key>
Arguments:
<key> The dotted key, such as `model` or `compaction.tokens`
Options:
-h, --help Print help
fiber config set
Write one key in one layer's file
Usage: fiber config set [OPTIONS] <key> <value>
Arguments:
<key> The dotted key, such as `model`
<value> The value as JSON, or a bare string when it does not parse as JSON
Options:
--project Write the per-project file in Fiber home
--repo Write the repository's `.fiber/config.json`
-h, --help Print help
fiber import
Copy another harness's configuration into Fiber home, once
Usage: fiber import <source>
Arguments:
<source> The harness to import from: `claude-code` or `codex` [possible values: claude-code, codex]
Options:
-h, --help Print help
fiber login
Store a provider's key or an extension's secret
Usage: fiber login [OPTIONS] [name]
Arguments:
[name] The installed provider to store a key for, or the declared secret to store. With none, a terminal offers the installed providers and the declared secrets
Options:
--as <label> The credential label to store a provider's key under. Without it the label is the account's email when the login reveals one, otherwise `default`
--device Log in with a device code instead of the browser, for a provider that logs in by browser
-h, --help Print help
fiber setup
Ask the questions a new install needs, applying each answer
Usage: fiber setup [OPTIONS]
Options:
--provider <name> Sign in to this provider, as `fiber login <name>` does. May repeat
--model <model> The default model, written to the global `config.json`
--thinking <level> The default thinking level for the model, written beside it
--import <claude-code | codex> Import this source's configuration, as `fiber import` does. May repeat [possible values: claude-code, codex]
--completions <shell> Install completions for this shell in its startup file [possible values: bash, zsh, fish]
--no-completions Leave the shell's startup file alone
--hub Register the hub as a login service, as `fiber hub install` does
--no-hub Leave the hub's login service alone
-h, --help Print help
fiber logout
Delete a provider's stored key
Usage: fiber logout [OPTIONS] [provider]
Arguments:
[provider] The provider whose stored key to delete. A missing provider is a usage error `fiber` words itself, so it matches the other sentences
Options:
--as <label> Delete this credential label alone
--all Delete every stored label
-h, --help Print help
fiber doctor
Say whether a session can start, and how to fix it when it cannot
Usage: fiber doctor
Options:
-h, --help Print help
fiber stop
Shut down every running session, then the hub
Usage: fiber stop [OPTIONS]
Options:
--hub <name> Use a hub from this client's list
-h, --help Print help
fiber feedback
Write a feedback report and print the issue link
Usage: fiber feedback [OPTIONS] [prompt]...
Arguments:
[prompt]... The description. A final `-` reads stdin
Options:
--session <session_id> The session whose diagnostics the report carries: any session in Fiber home. Without it, the newest session in this project
-h, --help Print help
fiber completion
Print a completion script for bash, zsh or fish
Usage: fiber completion <shell>
Arguments:
<shell> The shell to complete in [possible values: bash, zsh, fish]
Options:
-h, --help Print help
fiber version
Print the version
Usage: fiber version
Options:
-h, --help Print help
fiber help
Print this menu, or a command's help
Usage: fiber help [command]...
Arguments:
[command]... The command to describe, a word per level: `extension install`. Absent prints the menu
Options:
-h, --help Print help
fiber hub
Manage this client's hub list, the hub's service and paired devices
Usage: fiber hub <COMMAND>
Commands:
add Add a hub to this client's list
remove Remove a hub from this client's list
install Register the hub as a login service
uninstall Remove the hub's login service; running sessions carry on
status Print the hub's state: running, version, port, clients, devices, installed
refresh Rebuild the hub's environment for the sessions it starts from now on
pair Print a pairing code for a device of that name
token Manage paired devices
Options:
-h, --help Print help
fiber hub add
Add a hub to this client's list
Usage: fiber hub add [OPTIONS] <name> <address>
Arguments:
<name> The hub's name in this client's list
<address> A ws://, wss:// or unix: address
Options:
--default Use this hub when no --hub is given
-h, --help Print help
fiber hub remove
Remove a hub from this client's list
Usage: fiber hub remove <name>
Arguments:
<name> The hub's name in this client's list
Options:
-h, --help Print help
fiber hub install
Register the hub as a login service
Usage: fiber hub install [OPTIONS]
Options:
--port <port> Also listen on this port of `127.0.0.1`, where every connection presents a device token. Without it the hub listens on its local socket only
-h, --help Print help
fiber hub uninstall
Remove the hub's login service; running sessions carry on
Usage: fiber hub uninstall
Options:
-h, --help Print help
fiber hub status
Print the hub's state: running, version, port, clients, devices, installed
Usage: fiber hub status [OPTIONS]
Options:
--json Print one JSON object
-h, --help Print help
fiber hub refresh
Rebuild the hub's environment for the sessions it starts from now on
Usage: fiber hub refresh [OPTIONS]
Options:
--hub <name> Use a hub from this client's list
-h, --help Print help
fiber hub pair
Print a pairing code for a device of that name
Usage: fiber hub pair [OPTIONS] <device>
Arguments:
<device> The device to pair
Options:
--hub <name> Use a hub from this client's list
--address <url> The websocket address carried in the QR code
-h, --help Print help
fiber hub token
Manage paired devices
Usage: fiber hub token <COMMAND>
Commands:
list List paired devices: name, when paired, last connection
revoke Revoke a device's token and close its live connections
Options:
-h, --help Print help
fiber hub token list
List paired devices: name, when paired, last connection
Usage: fiber hub token list [OPTIONS]
Options:
--hub <name> Use a hub from this client's list
-h, --help Print help
fiber hub token revoke
Revoke a device's token and close its live connections
Usage: fiber hub token revoke [OPTIONS] <device>
Arguments:
<device> The device to revoke
Options:
--hub <name> Use a hub from this client's list
-h, --help Print help