ODS V3 Pre-Release: Public testing and refinement ahead of the official V3 launch. Turn your PC, Mac, or Linux box into a private AI server.
Python ai-agentsamdcomfyuidockerllama-cppllmlocal-ain8nnvidiaopen-webuiragself-hostedspeech-to-textstrix-halotext-to-speechworkflow-automation
title: Pixel CLI - Qualification, release, and migration doc_type: reference audience: [owner, operator, contributor, maintainer] feature_status: mixed owners: [documentation] sources_of_truth: [pixel] generated_by: scripts/docs/generate-cli-reference.mjs last_verified_at: generated
Qualification, release, and migration
Status boundary: Mixed; signatures, qualification, publication, staging, activation, and recovery are distinct authorities.
| Command | Purpose | Effect | Confirmation | Exit semantics | Normative source |
|---|---|---|---|---|---|
./pixel promotion-status |
Build a content-free, fail-closed release-readiness index | writes generated, private, evidence, or bounded task state | not declared by root help; this is not permission to mutate | 0 pass; 3 valid non-pass/blocked; 2 contract or operational error | scripts/promotion_readiness.py |
./pixel outcome-task-admit |
Admit one exact private backend-neutral evaluation task | may write state; inspect command help and owning guide | not declared by root help; this is not permission to mutate | 0 admitted; 2 contract or operational error | scripts/portal_outcome_task.py |
./pixel outcome-compare |
Compare exact private Pixel/Codex real-task outcome runs | may write state; inspect command help and owning guide | not declared by root help; this is not permission to mutate | 0 pass; 3 valid non-pass/blocked; 2 contract or operational error | scripts/portal_outcome_evaluation.py |
./pixel outcome-campaign |
Require every baseline and declared fault outcome pair | may write state; inspect command help and owning guide | not declared by root help; this is not permission to mutate | 0 pass; 3 valid non-pass/blocked; 2 contract or operational error | scripts/portal_outcome_campaign.py |
./pixel qualify-hosts |
Run the disposable Ubuntu/Debian real-systemd qualification matrix | writes generated, private, evidence, or bounded task state | not declared by root help; this is not permission to mutate | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/run-supported-host-systemd-matrix.sh |
./pixel release-manifest-migrate |
Convert an unversioned release manifest to schema v1 | may write state; inspect command help and owning guide | mode/subcommand-dependent; inspect help | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/migrate-release-manifest.mjs |
./pixel upstream |
Check registries or prepare a verified OpenClaw candidate | mode-dependent; includes non-mutating and state-writing modes | mode/subcommand-dependent; inspect help | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/upstream.mjs |
./pixel release-sign |
Sign one validated release-update envelope (requires --confirm) | state-changing or authority-affecting | required for the named mutation | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/release-update.py |
./pixel release-qualification-sign |
Sign one Candidate envelope for qualification only | mode-dependent; includes non-mutating and state-writing modes | mode/subcommand-dependent; inspect help | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/release-update.py |
./pixel release-qualification-inspect |
Verify a Candidate qualification signature without update authority | inspection or verification; may emit bounded evidence | mode/subcommand-dependent; inspect help | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/release-update.py |
./pixel release-qualification-prepare |
Copy one exact Candidate bundle into a disposable qualification root only (requires --confirm) | state-changing or authority-affecting | required for the named mutation | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/release-update.py |
./pixel release-qualification-rehearse |
Extract and parse one qualification-staged candidate without executing it (requires --confirm) | read-only or inert inspection | none for the named inspection/preview | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/release-update.py |
./pixel release-qualification-activation-preview |
Derive an exact qualification activation hash without executing candidate code | read-only or inert inspection | none for the named inspection/preview | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/release-update.py |
./pixel release-qualification-activation-claim |
Atomically claim one qualification-root-only activation without executing candidate code (requires --confirm) | read-only or inert inspection | none for the named inspection/preview | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/release-update.py |
./pixel release-qualification-host-run |
Atomically acquire one private host-run for an already-claimed qualification activation without executing candidate code (requires --confirm) | read-only or inert inspection | none for the named inspection/preview | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/release-update.py |
./pixel release-qualification-execution-claim |
Write the durable qualification execution claim before any candidate process may start (requires --confirm) | state-changing or authority-affecting | required for the named mutation | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/release-update.py |
./pixel release-qualification-execution-result |
Record the immutable content-free result of one claimed qualification execution (requires --confirm) | state-changing or authority-affecting | required for the named mutation | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/release-update.py |
./pixel release-qualification-execution-interruption-preview |
Inertly derive the exact terminal interruption hash for one post-start indeterminate qualification execution | may write state; inspect command help and owning guide | mode/subcommand-dependent; inspect help | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/release-update.py |
./pixel release-qualification-execution-interruption-record |
Write the two private immutable terminal interruption artifacts for one post-start indeterminate qualification execution (requires --confirm plus the exact preview hash) | read-only or inert inspection | none for the named inspection/preview | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/release-update.py |
./pixel release-qualification-host-execute |
Run one bounded candidate probe under disposable-host custody and emit a content-free observation (requires --confirm) | state-changing or authority-affecting | required for the named mutation | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/qualification-host-execution.py |
./pixel update-inspect |
Verify one signed release bundle without executing candidate code | read-only or inert inspection | none for the named inspection/preview | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/release-update.py |
./pixel update-prepare |
Copy one eligible verified bundle into private staging (requires --confirm) | state-changing or authority-affecting | required for the named mutation | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/prepare-release-update.sh |
./pixel update-rehearse |
Safely extract and parse one staged candidate (requires --confirm) | state-changing or authority-affecting | required for the named mutation | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/rehearse-release-update.sh |
./pixel update-activate |
Preview or transactionally activate one exact rehearsed candidate | mode-dependent; includes non-mutating and state-writing modes | mode/subcommand-dependent; inspect help | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/activate-release-update.sh |
./pixel update-reactivate |
Preview or re-activate one exact successfully rolled-back candidate | mode-dependent; includes non-mutating and state-writing modes | mode/subcommand-dependent; inspect help | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/reactivate-release-update.sh |
./pixel update-reactivation-rollback |
Preview or roll back one exact reactivated candidate | mode-dependent; includes non-mutating and state-writing modes | mode/subcommand-dependent; inspect help | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/rollback-reactivated-release-update.sh |
./pixel update-reactivation-recover |
Diagnose or finalize one interrupted reactivation receipt | mode-dependent; includes non-mutating and state-writing modes | mode/subcommand-dependent; inspect help | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/recover-reactivated-release-update.sh |
./pixel update-rollback |
Preview or restore one exact activated update (requires --confirm) | read-only or inert inspection | none for the named inspection/preview | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/rollback-release-update.sh |
./pixel update-recover |
Diagnose or finalize one interrupted update receipt (requires --confirm) | mode-dependent; includes non-mutating and state-writing modes | required for the named mutation | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/recover-release-update.sh |
./pixel update-cleanup |
Reclaim one completed rolled-back update after preserving audit history | mode-dependent; includes non-mutating and state-writing modes | mode/subcommand-dependent; inspect help | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/cleanup-release-update.sh |
./pixel update-archive |
Preserve one terminal failed rollback outside bounded staging (requires --confirm) | state-changing or authority-affecting | required for the named mutation | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/archive-release-update.sh |
./pixel update-reactivation-archive |
Preserve one terminal no-live-mutation reactivation failure outside bounded staging (requires --confirm) | state-changing or authority-affecting | required for the named mutation | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/archive-reactivation-failure.sh |
./pixel migrate-legacy-clean |
Review, rehearse, and finalize a terminal-only clean 3.2.2 to 4.2 migration | mode-dependent; includes non-mutating and state-writing modes | mode/subcommand-dependent; inspect help | 0 completed; nonzero is command-specific refusal/error—read stderr or JSON before acting | scripts/migrate-legacy-clean.py |
Use the owning guide before a state-changing command. Return to the CLI family index.