Scira

Commands

CLI and TUI slash command reference.

Quick reference

The three commands you need most:

 scira init       # First-time setup wizard
 scira            # Open the interactive TUI
 scira "question" # Headless — writes report.md and exits

CLI commands

CommandWhat it does
scira initInteractive setup for API keys and configuration
scira keysShow where to get and save missing API keys
scira doctorCheck credentials and environment health
sciraOpen the TUI home screen (or run headlessly with a question)
scira new <question>Start a new run; add --tui to open the TUI
scira resume <run-id>Resume a previous run in the TUI
scira listList all runs with status
scira show <run-id>Print run status and metadata
scira run <run-id>Re-run the research agent on an existing run
scira verify <run-id>Print the claim verification report
scira export <run-id>Export a report (--format md|json|csv, --output <path>)
scira watch <goal>Re-run research on a schedule and diff each report — add -b to run it in the background (Watch)
scira modelsList available models for the active provider
scira configPrint the resolved merged config
scira mcp …Manage MCP servers (see below)

MCP subcommands

 scira mcp list
 scira mcp add stdio <name> <command>
 scira mcp add sse  <name> <url>
 scira mcp add http <name> <url>
 scira mcp oauth   <name>
 scira mcp enable  <name>
 scira mcp disable <name>
 scira mcp remove  <name>

Watch subcommands

 scira watch "<goal>"                  # foreground loop (--daily by default)
 scira watch "<goal>" -b --every weekday --at 09:00 --name pricing
 scira watch list                      # scheduled watches + next run times
 scira watch remove <id>
 scira watch start                     # start the background scheduler
 scira watch status
 scira watch stop

See Watch for the foreground vs. background modes, the scheduler, and notifications.

Export formats

 scira export <run-id> --format md   --output report.md
 scira export <run-id> --format json --output data.json
 scira export <run-id> --format csv  --output data.csv     # sources + claims

TUI slash commands

Inside the interactive TUI, type / to open the command menu. It filters as you type, and Enter runs the highlighted command.

CommandWhat it does
/helpShow commands and keyboard shortcuts
/homeGo to the home screen
/newStart a new research run
/backReturn to the sessions list
/planToggle plan mode (explore and plan before changes)
/rerunRun the research agent again for this run
/rename <title>Set a title for the session
/reportShow report.md in the timeline
/sourcesList the run's gathered sources
/claimsList claims with id, confidence, status, and text
/why <claim-id>Show full detail for a single claim
/usageShow token usage per model for this session
/copyCopy the last answer (or report) to the clipboard
/modelOpen the model selector
/llmSwitch the LLM provider (gateway, xAI, Workers AI, Claude Code, Codex)
/providerOpen the search provider selector
/thinking <mode>Claude Code thinking: off, on, or adaptive
/reasoning <level>Codex reasoning effort: low, medium, or high
/theme <mode>Set the theme: dark, light, or auto
/links <mode>Link opens: always or ask
/key <NAME> <value>Save a key to ~/.scira/.env
/keysAPI key status and signup links
/mcpManage MCP servers
/stopAbort the current agent turn
/quitExit Scira

For the full interface — file mentions, session references, and tool-output navigation — see The TUI.

Keyboard shortcuts

KeyAction
EnterSubmit message or run the highlighted command
EscClear input, or abort the turn while running
Cycle input history (empty box)
PageUp PageDownScroll the timeline
cCollapse or expand tool-output groups
[ ]Focus the previous / next group
Ctrl+WDelete the previous word
Ctrl+DQuit (empty input)

Common workflows

Start a headless run and read the result:

 scira "compare vector database options in 2025"
 cat .scira/runs/<run-id>/report.md

Resume a run and keep researching:

 scira list
 scira resume <run-id> --tui

Track a topic in the background every weekday morning:

 scira watch "frontier model releases this week" -b --every weekday --at 08:30
 scira watch start
 scira watch status

Add an Exa MCP server and verify it loaded:

 scira mcp add http exa https://mcp.exa.ai/mcp
 scira doctor

Save an API key mid-session:

/key EXA_API_KEY ex-xxxxxxxxxxxxxxxx
/keys

On this page