01Start
saturday login saturday
Login verifies your free OpenRouter key live, then picks a model. Key, model, chats and history live in ~/.saturday/ — per machine, never in git. Free keys at openrouter.ai/keys.
02Brains
| saturday ask "why is this pending?" | coding Q&A — explain, review, how-to |
| saturday fix "TypeError: …" | diagnosis + minimal patch + verify command |
| saturday kicad ask "is C7 ok for 24V?" | hardware help — auto-reads your project folder |
In the TUI the brain is sticky — switch with /ask /fix /kicad or alt+1 2 3. Pipe input works too: echo "…" | saturday ask
03KiCad 10 local, no AI needed
| saturday kicad info --dir ./psu | symbols · sheets · footprints · tracks · ref check |
| saturday kicad symbols --dir ./psu | every symbol: ref, value, footprint |
| saturday kicad nets --dir ./psu | net list straight from the PCB |
| saturday kicad bom --dir ./psu --save bom.csv | BOM grouped by value + footprint |
| saturday kicad check --dir ./psu | sch ↔ pcb reference cross-check |
Parses .kicad_sch / .kicad_pcb S-expressions directly — tolerant from v6 to v10.
04VS Code
| saturday code open src/app.ts:42 | jump to file + line |
| saturday code diff a.ts b.ts | side-by-side diff |
| saturday code folder . | open a folder |
| saturday code status | CLI detection + workspace summary |
Inside the TUI: /code open src/app.ts:42. Needs the code shell command installed.
05TUI keys
| ↵ | send | ^J | newline in the box |
| tab | accept suggestion | esc | clear / close / cancel |
| ↑↓ | history · menu navigation | ←→ | move cursor |
| pgup/pgdn | scroll a page | shift+↑↓ | scroll lines |
| home/end | oldest message / follow live | ^C | quit |
Mention files with @path — contents are injected into the prompt. Scrolling up pins the view (▼ N new · End to follow); streaming never yanks you.
06MCP · sessions · models
| saturday mcp tools | fs_read · fs_list · fs_write · shell_run · … |
| saturday mcp call shell_run '{"cmd":"npm test"}' | run any tool (PowerShell: pipe JSON via --stdin) |
| saturday mcp add mytools -- npx -y my-mcp-server | plug in any stdio MCP server |
| saturday sessions | list chats (auto-saved, auto-resumed) |
| saturday models use 2 | prefer a free model — tried first |
| saturday history -n 10 | recent one-shot runs |
07FAQ
All models busy? The chain auto-falls-through to the next free model. Slugs rotate — refresh with saturday models.
PowerShell eats my JSON? Pipe it instead: echo '{"path":"."}' | saturday mcp call fs_list --stdin
Updating? Re-run the install line. Slow terminal? saturday tui --no-anim
Something flickers? Set SATURDAY_DEBUG=1 to log every render decision.