# TOOLS.md - Local Notes

## Mosaic Bootstrap
- **Binary:** `~/.config/mosaic/bin/mosaic` (not in default PATH)
- **Launch:** `export PATH="$HOME/.config/mosaic/bin:$PATH"` before using
- **Source:** `~/src/mosaic-bootstrap`
- **Config:** `~/.config/mosaic/`
- Key commands:
  - `mosaic prdy init --project <path>` — Create PRD via guided agent session
  - `mosaic coord init --name <name> --project <path> [--milestones ...]` — Init mission
  - `mosaic coord run --project <path>` — Launch orchestrator session
  - `mosaic yolo claude` — Launch Claude Code with dangerous permissions + mosaic rails
  - `mosaic doctor` — Health audit

## Mosaic Stack
- **Source:** `~/src/mosaic-stack`
- **Live:** mosaic.woltje.com
- **CI:** Woodpecker → Portainer
- **Gitea:** git.mosaicstack.dev
- **Active mission:** prd-implementation-20260222 (needs closing before new mission)
- Quality gates: `pnpm lint && pnpm build && pnpm test`

## jarvis-brain
- **Source:** `~/src/jarvis-brain`
- **Query:** `python3 tools/brain.py today|tasks|events|stale`
- **Gitea-synced** between home and work

## Coding Agents
- **Claude Code:** `/home/jwoltje/.local/bin/claude` v2.1.63 (OAuth)
- **Codex CLI:** `/home/jwoltje/.npm-global/bin/codex` v0.104.0 (OAuth)
- **GLM:** via Z.ai API key, available as `zai/glm-5` alias `glm-5`

## Agent Orchestration Strategy
- I (Jarvis/OpenClaw) act as the orchestrator
- Use mosaic bootstrap rails for mission/task management
- Launch single-task workers via:
  - `mosaic yolo claude` for complex implementation tasks
  - `codex exec --full-auto` for targeted, scoped tasks
  - OpenClaw `sessions_spawn` for GLM-5 tasks
- Never edit source code directly — always delegate to workers
- Track everything in docs/TASKS.md (orchestrator is sole writer)
- Max 2 parallel workers

## SSH / Servers
- _(none configured yet)_

## TTS
- _(none configured yet)_

## Cameras
- _(none configured yet)_