AgentSkillsCN

agent-stack-startup

在 Mac 新重启后，启动完整的代理栈（Claude Code 代理的 tmux 会话、SQLite 数据导入器、播报器、看门狗以及 mitmproxy）。当用户提出“启动一切”、“拉起代理栈”、“重启后启动”、“启动 tmux 会话”，或需要初始化包含所有监控与代理进程的开发环境时，应使用此技能。

SKILL.md
--- frontmatter
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:

bash
python /path/to/this/skill/scripts/startup_all.py

Or execute manually step-by-step (see Startup Procedure below).

What Gets Started

tmux sessionScriptPurpose
Hermionesetup_hermione_session.pyClaude Code agent in ~/TheSwarm/Armada
Doraemonsetup_doraemon_session.pyClaude Code agent in ~/swe
mitmsetup_mitm_session.pymitmweb + SSE logger (web UI: http://localhost:9115)
watchdog-claude-codesetup_cc_watchdog.pyWatches ~/.claude/projects, publishes to Redis
codex-sqlitesetup_codex_sqlite_session.pyCodex ingestor + announcer (2 panes)
claude-sqlitesetup_claude_sqlite_session.pyClaude 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