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