Rig Tools¶

Shared tooling for the Dashecorp engineering rig. Connects any AI-assisted development environment (Claude Code, Codex, Copilot, Cursor) and human developers to the Conductor-E event pipeline.

Quick Start¶

gh repo clone dashecorp/rig-tools
cd rig-tools
./install.sh

The installer: 1. Puts conductor-e-hook in ~/.local/bin/ 2. Sets CONDUCTOR_AGENT_ID and CONDUCTOR_URL in ~/.zshrc 3. Configures Claude Code hooks (if installed) 4. Prints setup instructions for other AI tools

How It Works¶

Every developer (human or AI) reports activity to Conductor-E via the same event pipeline:

Create branch    → WORK_STARTED event
Use AI tool      → HEARTBEAT events (automatic for Claude Code)
Create PR        → PR_CREATED event
CI fails         → Conductor-E routes it back to you
Review feedback  → Address comments, push, iterate
PR merged        → ISSUE_DONE (automatic via webhook)

Usage¶

Claude Code (automatic)¶

After ./install.sh, hooks fire automatically. No action needed.

Any other AI tool (Codex, Copilot, Cursor, etc.)¶

Call the CLI directly:

conductor-e-hook WORK_STARTED
conductor-e-hook HEARTBEAT working
conductor-e-hook PR_CREATED --pr 42 --url https://github.com/owner/repo/pull/42
conductor-e-hook HEARTBEAT idle

Git hook (any git client)¶

Auto-reports branch creation regardless of AI tool:

ln -sf ~/.local/bin/rig-git-post-checkout .git/hooks/post-checkout

Contents¶

install.sh                     One-command setup
hooks/conductor-e-hook.sh      Main hook (Claude Code stdin + CLI args)
hooks/git-post-checkout.sh     Git hook for branch tracking
scripts/sync-workflow.sh       Sync docs/agent-workflow.md to all repos
docs/agent-workflow.md         Single source of truth for dev workflow

Updating the Workflow¶

Edit docs/agent-workflow.md, then sync to all managed repos:

./scripts/sync-workflow.sh

This creates PRs in every managed repo (Stig-Johnny + dashecorp) updating the  section in AGENTS.md.

Resource	Location
Shared rig rules	dashecorp/rig-gitops/AGENTS.md
Doc standard	dashecorp/rig-gitops/docs/documentation-standard.md
Onboarding	dashecorp/rig-gitops/docs/onboarding.md
Conductor-E API	https://conductor-e.dashecorp.com