# Agent Stack Startup

> 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.

- Skill: `tankygranny05/agent-stack-startup` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tankygranny05/agent-stack-startup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tankygranny05/agent-stack-startup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tankygranny05 (https://skillmd.com/u/tankygranny05)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/tankygranny05/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:

```bash
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

```bash
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

```bash
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