sparrow-cli 0.4.0

A local-first Rust agent cockpit — route, run, replay, rewind
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

._ SPARROW(1)                General Commands Manual               SPARROW(1)

._N_A_M_E
     sparrow — one CLI · grows with you

._S_Y_N_O_P_S_I_S
     sparrow [--tui | --web] [--json] [--model id] [--local] [--budget usd]
             [--autonomy level] [--sandbox backend] [--profile name]
             [command] [args...]

._D_E_S_C_R_I_P_T_I_O_N
     Sparrow is a self-contained CLI for agentic coding. One binary, any
     model, no other CLI required.

     If no command is given, launches the terminal TUI.

._C_O_M_M_A_N_D_S
     run task        Execute a single agentic task.
     chat            Interactive multi-turn chat.
     swarm task      Run planner → coder → verifier pipeline.
     schedule task   Schedule a recurring job with --cron expression.
     model           Show or override model routing (--list, --set).
     auth            Manage provider credentials (add, list, rm).
     agent           Manage persistent agents (create, list, edit, rm, run).
     skills          Manage skill library (list, create, prune).
     mcp             Manage MCP connectors (add, list, rm).
     checkpoint      List git-based checkpoints.
     rewind id       Restore workspace to a checkpoint.
     replay run-id   Replay a transcript from a previous run.
     gateway         Start/stop the messaging daemon.
     profile         Manage isolated config profiles (create, list, use).
     import source   Migrate from another tool.
     config          Edit config.toml (--edit).
     update          Self-update to the latest version.
     doctor          Run diagnostics.
     setup           Interactive onboarding.
     learn           Interactive tutorial (5 lessons).
     memory          Manage persistent memory (list, forget, add).

._F_L_A_G_S
     --tui           Launch the terminal TUI.
     --web           Launch the webview console (browser).
     --json          Output events as NDJSON (for scripts/CI).
     --model id      Force a specific model.
     --local         Prefer local/Ollama models.
     --budget usd    Session budget cap in USD.
     --autonomy lvl  Override autonomy level (supervised|trusted|autonomous).
     --sandbox bknd  Select sandbox backend.
     --profile name  Use an isolated profile.
     --agent name    Run as a named persistent agent.

._E_N_V_I_R_O_N_M_E_N_T
     SPARROW_DEFAULTS_AUTONOMY
     SPARROW_DEFAULTS_SANDBOX
     SPARROW_BUDGET_DAILY
     SPARROW_BUDGET_SESSION
     SPARROW_THEME
     *_API_KEY           Provider-specific API keys.

._F_I_L_E_S
     ~/.config/sparrow/config.toml    Configuration file.
     ~/.local/state/sparrow/          State (database, transcripts).

._S_E_E _A_L_S_O
     Full documentation: https://github.com/ucav/Sparrow

._A_U_T_H_O_R
     Sparrow contributors.

Sparrow 0.1.0                    May 2026                        SPARROW(1)