Installation

Installation

build-loop ships three agent surfaces from one source. build-loop-install runs the package's helpers from the installed npm package: it syncs the Claude Code cache from the package root, syncs the Codex cache from plugin-artifacts/codex, and bootstraps the build-loop memory root with public templates. It leaves publishing, GitHub releases, and production deploys to explicit release commands.

Quick install (macOS, all hosts)

npm install -g @tyroneross/build-loop@0.36.0
build-loop-install --host all

GitHub Packages

Authenticate first and point the @tyroneross scope at the GitHub registry:

npm config set @tyroneross:registry https://npm.pkg.github.com
npm login --scope=@tyroneross --registry=https://npm.pkg.github.com
npm install -g @tyroneross/build-loop@0.36.0
build-loop-install --host all

Installer options

Option	Use
--host claude	Sync only the Claude Code cache.
--host codex	Sync only the Codex cache.
--host all	Sync both caches. This is the default.
--project <slug>	Ensure projects/<slug>/raw/ exists in build-loop memory. Repeatable.
--memory-dest <path>	Override the memory root.
--skip-memory	Sync plugin caches only.
--dry-run	Show cache sync actions without writing.
--json	Emit one machine-readable result.

Local development install

git clone https://github.com/tyroneross/build-loop.git
cd build-loop
npm install
npm run build
python3 scripts/sync_plugin_cache.py --source . --host claude
npm run codex:sync-cache
python3 scripts/install_memory.py --ensure-project build-loop

Host surfaces

• Claude Code plugin — plugin metadata, commands, hooks, and agents/*.md.
• Codex plugin — Codex metadata plus a slim public skill entrypoint (plugin-artifacts/codex/).
• Host-neutral AGENTS.md — the same loop methodology for any AGENTS.md-aware tool (Copilot, Cursor, and others), with no Claude-specific integration required.

Surface counts in this release: ~18 commands, ~40 skills, ~28 agents.

Agent start protocol

Start every build-loop repo session by checking Rally for coordination state — peers, claims, handoffs, and soft file conflicts. Rally verifies nothing on its own; confirm code, package, version, and release truth from git, tests, manifests, registries, or GitHub directly.

rally enter --tool claude_code --json
rally next --tool claude_code --json
rally check before-write --tool claude_code --path README.md --strict --json

If the Rally binary is not installed, proceed without it.