// reference

CLI reference

Run Astra interactively in a TUI, or headless with -p for scripts, hooks, and CI.

Flags

npm run dev                                    # Interactive TUI
npm run dev -- -p "List files in src"          # Print mode (no TUI)
npm run dev -- --boss                          # Start in boss orchestrator mode
npm run dev -- --boss -p "refactor auth module" # Boss mode, print and exit
npm run dev -- --multi                         # Start in multi-agent (parallel) mode
npm run dev -- --multi -p "add tests for utils" # Multi-agent mode, print and exit
npm run dev -- -c                              # Continue last session
npm run dev -- --model groq/llama-3.3-70b-versatile "hello"
npm run build && npm start                     # Production build

Flag	Description
`-p`, `--print`	Print the response and exit — no TUI.
`-c`, `--continue`	Resume the most recent session.
`--model <ref>`	Start with a specific `provider/model-id`.
`--boss`	Enable the boss orchestrator mode.
`--multi`	Enable multi-agent (parallel) orchestrator mode.
`--no-compact`	Disable context compaction.

Interactive commands

Inside the TUI, prefix any of these with /:

Command	Description
`/model`, `/m`	Open the model selector, grouped by provider.
`/build`	Switch to Build mode (full tool access).
`/plan`	Switch to Plan mode (read-only exploration).
`/boss`	Toggle the boss orchestrator.
`/multi`	Toggle the multi-agent (parallel) orchestrator.
`/agents`	List agent runs from the current multi-agent session.
`/tasks`	Show the active task plan.
`/compact`	Summarize older messages to free context.
`/rules`	List loaded project rule files (`AGENTS.md`, etc.).
`/permissions`	Show merged permission presets for this project.
`/trace`	Show the path to the latest worker trace log.
`/sessions`	Browse and load saved chat sessions.
`/settings`	Thinking level and API key status.
`/connect`	Configure a gateway connection (Telegram, Discord, WhatsApp).
`/skills`	Browse and install skills.
`/skill <name>`	Load a skill for the current turn.
`/voice`	Speak a task (voice input).
`/new`	Start a new session.
`/quit`	Exit.

Headless commands

Twitter batch runner

Post and reply on X/Twitter fully unattended — zero approvals — from a JSON schedule:

astra twitter-batch schedule.json

See Tools → Twitter for the schedule format and report output.

Testing & evaluation

npm test                 # Run the test suite
npm run test:watch       # Watch mode
npm run test:coverage    # Coverage report
npm run eval             # Agent evaluation suite (smoke, optional)
npm run eval:full        # Full agent evaluations (expensive)
npm run eval:deterministic  # Deterministic evals (no API keys)