| name | agentpack-operator |
| description | Operate agentpack safely (doctor/update/preview/diff/deploy/status/explain/evolve/rollback). Prefer --json. |
| agentpack_version | {{AGENTPACK_VERSION}} |
| metadata | {"short-description":"Operate Agentpack safely."} |
agentpack-operator
Operate Agentpack safely and reproducibly.
What you can do
- Self-check environment:
agentpack doctor --json
- Update sources:
agentpack update --yes --json
- Preview changes:
agentpack preview --json (or agentpack plan --json + agentpack diff --json)
- Apply changes:
agentpack deploy --apply --yes --json
- Verify drift:
agentpack status --json
- Explain why things look the way they do:
agentpack explain plan|diff|status --json
- Record outcomes and score modules:
agentpack record + agentpack score
- Propose overlay updates from drift:
agentpack evolve propose --yes --json
- Roll back:
agentpack rollback --to <snapshot_id>
Safety rules
- Never run
deploy --apply unless the user explicitly asked to apply.
- Always show the
plan + (optional) diff summary first.
- Prefer
--json for machine parsing; keep outputs small and scoped.
- Use
--repo, --profile, --target when operating outside defaults.
Typical workflow
0) Doctor
agentpack doctor --json
0.5) Update (optional)
agentpack update --yes --json
1) Plan
agentpack plan --json
2) Diff (optional)
agentpack diff --json
3) Apply (only with user approval)
agentpack deploy --apply --yes --json
4) Status
agentpack status --json
AI-first feedback loop (optional)
Explain (optional)
agentpack explain status --json
Record + score (optional)
Record a lightweight execution event (example):
echo '{"module_id":"command:ap-deploy","success":true}' | agentpack record
agentpack score
Evolve overlays (optional)
Capture drifted deployed files into overlays (creates a local git branch):
agentpack evolve propose --yes --json
