Additive. Old packages stay fully supported. This is the recommended entry for new users, forks, and agents.
Loop Engineering ships several focused CLIs (loop-init, loop-audit, loop-cost, …). That is great for maintainers; it is hard for first-time adopters to remember.
@cobusgreyling/loop is a thin umbrella:
- One binary people can remember
- Pass-through to existing tools (same flags)
- doctor / status for activation and day-2 habit
npx @cobusgreyling/loop init . -p daily-triage -t grok
npx @cobusgreyling/loop doctor .
| Front door | Existing package / command |
|---|---|
loop init … |
npx @cobusgreyling/loop-init … |
loop audit … |
npx @cobusgreyling/loop-audit … |
loop cost … |
npx @cobusgreyling/loop-cost … |
loop sync … |
npx @cobusgreyling/loop-sync … |
loop context … |
npx @cobusgreyling/loop-context … |
loop worktree … |
npx @cobusgreyling/loop-worktree … |
loop gate … |
npx @cobusgreyling/loop-gate … |
loop mcp … |
npx @cobusgreyling/loop-mcp-server … |
loop badge . |
loop-audit . --badge |
loop doctor . |
new (audit + sync + files) |
loop status . |
new (run-log dashboard) |
loop init with --with-foundry supports custom provider flags such as --model-provider minimax --region (global_en|cn_zh) --model MiniMax-M3. See QUICKSTART for examples.
| Code | Meaning | CI use |
|---|---|---|
| 0 | Healthy | green |
| 1 | Warnings | soft-fail or comment |
| 2 | Blocked | hard-fail if you require scaffold |
npx @cobusgreyling/loop doctor . --json- Forks that already call
loop-init/loop-audit: change nothing. - New docs / skills / Actions: prefer
loop. - Contributors adding tools: keep a dedicated package; add a one-line pass-through in
tools/loopif it should be discoverable.
skills/install-loop/SKILL.md — copy into .grok/skills, .claude/skills, etc., or point agents at this path.
git tag loop-v0.1.0
git push origin loop-v0.1.0Workflow: .github/workflows/release-loop.yml. See RELEASE.md.
0.xwhile the umbrella settles; pass-through tracks whatever sibling versions are installed via monorepo dist or npx.- No deprecation of sibling packages in this phase.