Agent Stack Startup

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

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