| name | agent-stack-startup |
| description | Start the full agent stack (tmux sessions for Claude Code agents, SQLite ingestors, announcers, watchdog, and mitmproxy) after a fresh Mac reboot. This skill should be used when the user asks to "start everything", "bring up the agent stack", "start after reboot", "launch tmux sessions", or needs to initialize the development environment with all monitoring and agent processes. |
Agent Stack Startup
Overview
This skill brings a Mac from a fresh reboot to a fully running "agent + ingestion + observability" setup using tmux sessions managed by scripts in /Users/sotola/KnowledgeBase/startup.
When to Use
- After a fresh Mac reboot
- When the user asks to "start the agent stack" or "bring up everything"
- When tmux sessions need to be (re)created for agents and monitoring
Quick Start
To start the entire stack with a single command, run the bundled script:
python /path/to/this/skill/scripts/startup_all.py
Or execute manually step-by-step (see Startup Procedure below).
What Gets Started
| tmux session | Script | Purpose |
|---|
Hermione | setup_hermione_session.py | Claude Code agent in ~/TheSwarm/Armada |
Doraemon | setup_doraemon_session.py | Claude Code agent in ~/swe |
mitm | setup_mitm_session.py | mitmweb + SSE logger (web UI: http://localhost:9115) |
watchdog-claude-code | setup_cc_watchdog.py | Watches ~/.claude/projects, publishes to Redis |
codex-sqlite | setup_codex_sqlite_session.py | Codex ingestor + announcer (2 panes) |
claude-sqlite | setup_claude_sqlite_session.py | Claude ingestor + announcer (2 panes) |
Data Flow
Inputs (SSE logs)
- Codex CLI:
~/centralized-logs/codex/sse_lines.jsonl
- Claude Code:
~/centralized-logs/claude/sse_lines.jsonl
Outputs (SQLite + deltas)
- Codex DB:
~/centralized-logs/sqlite-dbs/codex-rounds.sqlite
- Claude DB:
~/centralized-logs/sqlite-dbs/claude-rounds.sqlite
- Tee logs:
/tmp/soto_logs/codex-sqlite.log, /tmp/soto_logs/claude-sqlite.log
Startup Procedure (Manual)
1. Start All Sessions
cd /Users/sotola/KnowledgeBase/startup && \
python setup_hermione_session.py && \
python setup_doraemon_session.py && \
python setup_mitm_session.py && \
python setup_cc_watchdog.py && \
python setup_codex_sqlite_session.py && \
python setup_claude_sqlite_session.py
2. Verify
tmux ls
Expected: Hermione, Doraemon, mitm, watchdog-claude-code, codex-sqlite, claude-sqlite
Troubleshooting
- Check ingestor logs:
tail -n 200 /tmp/soto_logs/codex-sqlite.log or tail -n 200 /tmp/soto_logs/claude-sqlite.log
- Restart any service: Re-run its setup script from
/Users/sotola/KnowledgeBase/startup
Resources
scripts/
startup_all.py - Single script that creates symlinks and starts all tmux sessions
