Claudius

Autonomous orchestration layer for Claude Code.

Claudius sits on top of CC's native features (agent teams, hooks, skills, MCP, persistent memory, worktree isolation) to maximize autonomous potential across any project — round-the-clock autonomous work, minimal human intervention, within human-set constraints.

Setup

git clone https://github.com/SharadKumar/claudius.git
cd claudius
bun install
bun run build

Load as Plugin

# Run Claude Code with Claudius loaded from your local checkout
claude --plugin-dir /path/to/claudius

CLI

npx claudius-core init    # Scaffold .claudius/ config in a target project
claudius daemon install    # Install heartbeat as login service

Usage

/build #42           # Implement ready work item #42
/build               # Pick next ready issue

/backlog #8          # Decompose spec epic into work items
/backlog "add cache" # Capture ad-hoc work item
/review              # Code review current changes
/reflect             # Session retro → memory

/pulse               # Status: recent work, budget, upcoming
/pulse run           # Trigger one autonomous cycle
/pulse ideate        # Brainstorm improvements, create issues

Releases

Versioned releases are available on GitHub Releases. Each release includes a changelog and a claudius-vX.Y.Z.tar.gz plugin bundle you can load directly.

• CHANGELOG.md — full version history

# Pin to a specific version
VERSION=0.1.0
curl -L https://github.com/SharadKumar/claudius/releases/download/v${VERSION}/claudius-v${VERSION}.tar.gz \
  | tar -xz -C ~/claudius-v${VERSION}
claude --plugin-dir ~/claudius-v${VERSION}

Architecture

Engagement Layer (terminal / chat-sdk)
    ↓
Orchestration Layer (3 agents, 8 skills, 4 hooks, 2 rules)
    ↓
Tracking Layer (GitHub CLI)
    ↓
Execution Layer (Claude Code native)
    ↓
Deploy Layer (Vercel / Fly.io)

Project Structure

All plugin components live under .claude/ — single source of truth for both the plugin system and claudius init:

.claude/
  agents/          # manager, builder, reviewer
  skills/          # product, solution, spec, backlog, build, pulse, reflect, review
  hooks/           # guardian, cost-watch, context-inject, etc.
  commands/        # slash command definitions
  rules/           # workflow, autonomy, continuity
  settings.json    # hooks wiring
.claude-plugin/
  plugin.json      # explicit paths to all components
  marketplace.json
.claudius/
  config.yaml      # per-project config (scaffolded by init)
  personality.md
  jobs/            # scheduled job definitions
src/
  templates/       # config templates for claudius init

Agents

| Agent | Role | Model | |-------|------|-------| | Orchestrator | Routes work, spawns teams | sonnet | | Builder | TDD implementation | sonnet | | Reviewer | Quality gate | opus |

Configuration

Create .claudius/config.yaml in your project:

engage: terminal
deploy: vercel

commands:
  test: bun test
  lint: bun run lint
  build: bun run build

autonomy:
  budgetCapUsd: 50
  autoMerge: false

heartbeat:
  enabled: true
  intervalMinutes: 15
  activeHours: { start: "09:00", end: "22:00" }

Heartbeat Daemon

Always-on autonomous development:

claudius daemon install    # Auto-start on login
claudius daemon start      # Manual start
claudius daemon status     # Stats

Each pulse cycle: check constraints → pick ready issue → implement → review → PR → sleep.

Development

bun install
bun run build
bun test
bun run lint

License

MIT