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 rig-conductor event pipeline.

Quick Start¶

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

The installer: 1. Puts rig-conductor-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 rig-conductor 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         → rig-conductor 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:

rig-conductor-hook WORK_STARTED
rig-conductor-hook HEARTBEAT working
rig-conductor-hook PR_CREATED --pr 42 --url https://github.com/owner/repo/pull/42
rig-conductor-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/rig-conductor-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
rig-conductor API	https://rig-conductor.dashecorp.com