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.

rig-node: this machine's sessions in the Rig Cockpit¶

rig-node/ is a per-machine agent that reports which Claude Code sessions run on the machine, what each works on and its state, to the Rig Cockpit. It is installed per OS user, only on machines where every company served allows reporting. Setup, what leaves the machine and uninstall: rig-node/README.md.

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