Unified front door for Loop Engineering CLIs.
npx @cobusgreyling/loop init . --pattern daily-triage --tool grok
npx @cobusgreyling/loop doctor .This package does not replace loop-init, loop-audit, or the other tools. It wraps them and adds doctor + status so week-one activation is one mental model.
| Command | Delegates to | Notes |
|---|---|---|
loop init |
@cobusgreyling/loop-init |
Scaffold pattern + tool |
loop audit |
@cobusgreyling/loop-audit |
Loop Ready score |
loop cost |
@cobusgreyling/loop-cost |
Token estimates |
loop sync |
@cobusgreyling/loop-sync |
STATE ↔ LOOP drift |
loop doctor |
audit + sync + files | New — top 3 actions, exit codes |
loop status |
files + audit | New — run-log dashboard |
loop badge |
loop-audit --badge |
README badge |
loop context |
@cobusgreyling/loop-context |
Circuit breaker / memory |
loop worktree |
@cobusgreyling/loop-worktree |
Isolated fix attempts |
loop gate |
@cobusgreyling/loop-gate |
Path denylist |
loop mcp |
@cobusgreyling/loop-mcp-server |
MCP server |
loop sandbox |
@cobusgreyling/loop-sandbox |
Sandbox helper (if present) |
# 1. Scaffold (report-only)
npx @cobusgreyling/loop init . --pattern daily-triage --tool grok
# 2. One health check
npx @cobusgreyling/loop doctor .
# 3. Optional cost estimate
npx @cobusgreyling/loop cost -p daily-triage -l L1 -c 1d
# 4. Day-2 dashboard
npx @cobusgreyling/loop status .| Code | Meaning |
|---|---|
0 |
Healthy |
1 |
Warnings (gaps, mild drift, incomplete budget/run-log) |
2 |
Blocked (score < 40, critical drift, or not scaffolded) |
npx @cobusgreyling/loop doctor . --json
npx @cobusgreyling/loop status . --jsonThese continue to work forever (or until a future major with long deprecation):
npx @cobusgreyling/loop-init .
npx @cobusgreyling/loop-audit . --suggest
npx @cobusgreyling/loop-cost --pattern daily-triage
npx @cobusgreyling/loop-sync .loop <cmd> is the same binary behavior for pass-through commands.
# Build sibling tools first (audit + sync used by doctor)
(cd ../readiness-core && npm ci && npm run build)
(cd ../loop-audit && npm ci && npm run build)
(cd ../loop-sync && npm ci && npm run build)
(cd ../loop-init && npm ci && npm run build)
cd ../loop
npm ci
npm test
node dist/cli.js doctor ../..
node dist/cli.js status ../..See skills/install-loop in the monorepo — a short skill agents can follow to install and doctor a project.
MIT