stack/TOOLS.md

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)