---

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

1. Never run deploy --apply unless the user explicitly asked to apply.
2. Always show the plan + (optional) diff summary first.
3. Prefer --json for machine parsing; keep outputs small and scoped.
4. Use --repo, --profile, --target when operating outside defaults.

Typical workflow

0) Doctor

Copyagentpack doctor --json

0.5) Update (optional)

Copyagentpack update --yes --json

1) Plan

Copyagentpack plan --json

2) Diff (optional)

Copyagentpack diff --json

3) Apply (only with user approval)

Copyagentpack deploy --apply --yes --json

4) Status

Copyagentpack status --json

AI-first feedback loop (optional)

Explain (optional)

Copyagentpack explain status --json

Record + score (optional)

Record a lightweight execution event (example):

Copyecho '{"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):

Copyagentpack evolve propose --yes --json