Skip to content

The TUI

care (no subcommand) launches the Textual TUI. It opens directly into the chat surface — a Claude-Code-style transcript with a prompt at the bottom and a mode toggle above it.

  • Type a task in natural language → MAGE generates a chain, CARL runs it, the answer prints inline.
  • Type a slash command (/help, /library, …) for the non-chat affordances.
  • The mode toggle above the prompt switches Interactive ↔ Production — Interactive is the default.
  • Inspect the chain behind any answer: chat exposes chain DAG affordances to step through the graph, and an Artifacts pill collects the files a run produced.
  • First-time users get a one-line offer to type /tour for a 5-step walkthrough.

As MAGE generates and CARL executes, the transcript shows a stage trail — ▶ Friendly Label… lines that complete to ✓, with ⎿ sub-rows for details. The status bar tracks token usage live.

Reference files inline with @<path> — e.g. summarise @report.pdf. PDFs are text-extracted; images are embedded for vision-capable models. Quoting works for paths with spaces: @"My Notes.md".

KeyAction
Ctrl+PCommand palette (fuzzy over commands + saved entities).
Ctrl+BTask list drawer (in-flight workers).
Ctrl+KCapability catalog (skills / MCP / tools).
?Help — tutorial + every binding for the active screen.
Ctrl+CQuit.

Each screen layers its own bindings — press ? for the set filtered to the screen you’re on.