Architecture

Tech stack

How a command flows through the CLI

index.ts boots the program and parses argv. cli.ts maps each command to an action and validates flags like --mode. AI-facing commands pass through an environment guard that checks Node's version and your API key before doing anything else.

• wakeup and chat build a streaming session (an input bridge feeding the SDK's AsyncGenerator mode), staying alive until you exit.
• talk uses the single-shot path, passing a plain string prompt to the SDK and streaming the result.
• Both paths share the same mode-to-permissions mapping and the same message renderer.

Message rendering

As the SDK streams different message types, a single renderer decides how each one is displayed: assistant text and tool calls in one color, tool results in another, and a final summary line with turn count and cost. It collects output for a turn before printing, so long tool-heavy turns don't produce a pile-up of empty status tags.