ccx.sh
> _
git clone https://github.com/MoujahidAnas/CCX.git View on GitHub →

What's actually under the hood

Not just Claude Code + Slack. Here's what's underneath:

Layer 1: What you see
Slack message
→
PR + screenshots
Layer 2: The orchestration
Manager daemon — always-on, Slack communication, monitors Worker
Worker process — executes missions, never talks to humans
Filesystem IPC — missions/pending/, active.json, completed/
Layer 3: The methodology
RPTIV — 5 phases, each with dedicated sub-agent
Research → Plan → Test → Implement → Validate
Each phase produces artifacts in thoughts/shared/
Layer 4: The resilience
5 lifecycle hooks — PreCompact, SessionStart, TeammateIdle, TaskCompleted, Stop
3-tier crash detection — 18s background monitor, 120s Manager poll, 60s systemd watchdog
Compaction survival — state files persist through multi-hour missions
Quality gates — 8-point acceptance checklist blocks incomplete work

RPTIV in action

Structured methodology. Every mission. No exceptions.

[1] Research ████████████ done
→ thoughts/shared/research/

Spawn parallel sub-agents to understand existing codebase

[2] Plan ████████████ done
→ thoughts/shared/plans/

Interactive planning with zero open questions

[3] Test ████████████ done
→ thoughts/shared/validation/*-tests.md

Define ALL tests before implementation begins

[4] Implement ████████░░░░ 67%
→ src/

Execute plan, adapt to reality, update checkboxes

[5] Validate ░░░░░░░░░░░░ queued
→ screenshots + test results

Run all tests, visual verification, determine PASS/FAIL

What CCX adds

vs vanilla Claude Code

Communication
terminal
→
Slack (async, mobile)
Availability
session-scoped
→
always-on daemon
Crash recovery
lost
→
auto-restart + state persistence
Methodology
ad hoc
→
RPTIV with sub-agents
Visual QA
none
→
Playwright screenshots @ 3 viewports
Quality gates
none
→
hooks block incomplete work

Quick Start

Two ways to run CCX

VPS Mode (always-on daemon)

ssh your-vps
git clone https://github.com/MoujahidAnas/CCX.git ~/ccx
claude  # tell it: "Set up CCX following deploy/README.md"

Runs as systemd service, communicates via Slack, always available.

Local Mode (run on any project)

git clone https://github.com/MoujahidAnas/CCX.git
cd ~/your-project
~/ccx/ccx install && ~/ccx/ccx run "Add JWT auth"

One-off missions on any codebase, no daemon required.