Quick Start

First Session

Launch Aura to start an interactive session:

aura

Type a prompt and press Enter. Aura streams the response and executes tools as needed.

Run a single prompt non-interactively with aura run:

aura run "Write a Go function that reverses a string"

Pipe input from stdin:

echo "Explain this error" | aura run

Override the agent:

aura --agent high run "Summarize the changes in git diff"

Agents define which model, provider, and system prompt to use. Switch with Shift+Tab or /agent.

Edit or add agent files in .aura/config/agents/.

Modes control which tools are available. Switch with Tab or /mode.

Key	Action
`Enter`	Send message
`Alt+Enter`	Insert newline
`Ctrl+C`	Copy selection / clear input / cancel / quit
`Esc`	Cancel current streaming
`Tab`	Cycle mode
`Shift+Tab`	Cycle agent
`Ctrl+T`	Toggle thinking visibility
`Ctrl+R`	Toggle thinking on/off
`Ctrl+E`	Cycle thinking level
`Ctrl+A`	Toggle auto mode
`Ctrl+S`	Toggle sandbox
`Ctrl+O`	Open full tool output in pager
`PgUp` / `PgDn`	Scroll chat history

See Keybindings for the full list.