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

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

SKILL.md