coding-swarm-agent

Summary

Event-driven multi-agent coding orchestration for OpenClaw. This workspace dispatches Codex and Claude Code agents via tmux, with automatic token tracking, event dispatch notifications, and Telegram alerts. Designed to streamline collaborative coding sessions by integrating notification, memory, and skill management.

Included Assets

• Agent and Workspace Configuration
  • AGENTS.md — agent workspace overview
  • SOUL.md — agent persona and behavioral guidelines
  • TOOLS.md — environment-specific notes
• Memory and Session Tracking
  • MEMORY.md — long-term memory
  • memory/YYYY-MM-DD.md — daily logs (various dates)
• Project Skills and Workflow
  • skills/coding-swarm-agent/projects/README.md — project-specific memory structure
  • docs/agent-swarm-playbook.md — swarm automation best practices and architecture
• Session Records
  • Various memory/ files — detailed conversation logs, troubleshooting, task solutions, upgrade records, and session context

How to Use

1. Workspace Preparation

   • Review AGENTS.md for workspace routines and context.
   • Configure agent persona via SOUL.md as needed.
   • Record local environment details in TOOLS.md.

2. Agent Orchestration

   • Agents are dispatched in parallel via tmux.
   • Codex and Claude Code agents execute tasks, with outputs tracked for token usage.
   • Task status and activity are automatically updated and notified via Telegram integration.

3. Session Memory

   • Reference daily files in memory/ for session continuity.
   • Maintain curated context and long-term notes in MEMORY.md.

4. Coding Swarm Workflow

   • Follow best practices and architecture guides in docs/agent-swarm-playbook.md.
   • Use project-specific patterns from skills/coding-swarm-agent/projects/README.md.

Notes

• Telegram alerts require configured bot tokens and chat IDs in the environment.
• Token tracking is automated for both Codex and Claude Code agents.
• Session and memory files facilitate persistent context, aiding continuity across coding sessions.
• Daily memory files (memory/YYYY-MM-DD.md) are intended for raw session logs. Periodically distill important context into MEMORY.md.
• See the Agent Swarm Playbook for advanced orchestration scenarios and troubleshooting strategies.
• All scripts and orchestration are Shell-based; ensure tmux and relevant agent CLIs are installed and accessible on your system.