agent-stack-startup

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