Arch1eSUN/Arcgentic
View on GitHub ↗Mechanical plan/dev/self-audit/external-audit gates for AI coding agents, with a configurable role-routing topology engine, an MCP-UI live status panel, and native-tooling Claude Code V2 dispatch. Claude Code, Codex, OpenClaw, and PyPI.
270 ★0 forksPythonUpdated 23d ago
What you need to know
A harness-engineering layer for Codex and Claude Code that turns ad-hoc prompting into a gated workflow — fixed roles (Orchestrator, Planner, Developer, Test, Auditor), handoffs, stop states, audits, and evidence.
Install
pipx install arcgentic npm install -g arcgentic && arcgentic install-codex-local git clone https://github.com/Arch1eSUN/Arcgentic.git && cd arcgentic && bash scripts/install-codex-local.sh --plugin-root .
Usage
- •Start inside a project and ask 'Use Arcgentic to build this idea: <your idea>'.
- •Let the Orchestrator recommend a mode (single-session multi-agent vs multi-session multi-thread) and confirm or override it once per project.
- •Optional live status panel: pip install 'arcgentic[mcp]' and add arcgentic mcp-serve to .mcp.json (needs an MCP-Apps-capable host).
- •Follow PASS / NEEDS_FIX / AUDIT_INCOMPLETE verdicts and reuse the fixed role sessions rather than spawning new ones.
Key features
- ✓Automated role dispatch across planning, development, self-audit, optional user testing, external audit, and closeout.
- ✓Custom role/state Topology override validated at parse time; zero-config projects keep the exact 5-role sequence.
- ✓Codex V2 is verified in real workflows; Claude Code single-session-subagent mode has real-session dogfood evidence.
- ✓Optional MCP-UI round-status panel with client-side auto-refresh and a dispatch button (no write path of its own).
Best for
Heavy Codex/Claude Code users and AI-native teams doing complex, multi-round engineering that must remain auditable.
Caveats
- ⚠Claude Code V2 is experimental: multi-session-subthread mode and the hook-backed fallback path are unverified — you may need to copy role return messages back manually.
- ⚠Intentionally heavier than normal prompting; overkill for one-line commands, tiny edits, or quick experiments.
- ⚠MCP-UI panel requires a host with MCP Apps support (a graphical client, not a bare terminal session).
- ⚠MIT; v2.2.0.
Platforms: LocalClients: Codex · Claude Code
Reviewed 2026-08-18
Topics
agenticai-agentsai-codingai-coding-agentsclaude-codeclaude-code-plugincodex-plugindeveloper-toolsexternal-auditmcpmodel-context-protocolopenclawpluginround-driven-developmentsoftware-auditstate-machineworkflow
- Stars
- 270★
- Forks
- 0
- Language
- Python
- License
- MIT
- Created
- 2026-05-12
- Last push
- 2026-08-12