CLI 2.1

CLI 2.1 (Planned — NOT YET SHIPPED)

Status: planned scope only. Nothing below is shipped; the desktop app remains the only working surface.

Planned: a local-only terminal companion (nexora) with a full-screen TUI over TTY and pipe-safe non-interactive commands.

Planned command tree (scope)

• nexora (TTY → TUI; redirected/CI/no-TTY must not open a TUI), --help / --version (fast, offline, no network).
• run <prompt> with --provider, --model, --mode (supervised|semi_autonomous|full_autonomous), --max-steps, --budget-usd, --workspace, --format (text|json|jsonl), --plain, --no-color, --quiet, --verbose; prompt also via stdin; never waits for input when non-interactive.
• resume [session-id] (opening does not auto-run), sessions (list|open|rename|archive|delete), models list / providers list (shared registry facts), config (get|set) allow-listed keys only (secrets never via config), diff [session-id] (view only), doctor (offline, no paid calls), logs [--follow].

Planned safety rules (scope)

• CLI overrides never silently mutate globals; validate before launch; defaults match desktop/shared-core defaults.
• Budget shown as limit/estimate, never guaranteed cost; --mode full_autonomous does not lift the shell/permission floor.
• --format json|jsonl keeps stdout machine-only (no ANSI/banner) with diagnostics on stderr; --quiet never suppresses errors or approval-safety signals.
• Approval-required while non-interactive ends deterministically with how-to-repeat instructions — never silent auto-approval.

Planned TUI (scope)

Four zones top-to-bottom (status line, timeline viewport, composer, key hints); composer-first focus, overlays for sessions/setup/pause/approval/diff that preserve run, draft, and scroll; explicit too-small-terminal message instead of broken rendering.

See also: Product-Overview, Autonomy-and-Approvals, Roadmap.