Generated command catalog
Guided Commands
Primary user and lifecycle operations generated from surface=orchestrator.
| Command | Group | Surface | Safety | Dry-run | When to use | Parameters | Kit version | Manifest |
|---|---|---|---|---|---|---|---|---|
agentic-kit init | root | orchestrator | BOUNDED | no | Create a governed project skeleton with selected profiles and policy packs. | name name; project_type --type default=python-cli; description --description; license_name --license default=MIT; github_actions --github-actions default=True; pre_commit --pre-commit default=True; agent_docs --agent-docs default=True; logging_evidence --logging-evidence default=True; profiles --profiles; policy_packs --policy-packs; github --github default=False; github_owner --owner; visibility --visibility default=private; kit_source --kit-source default=pypi | 1.1.0 | a6ee797254ff |
agentic-kit workspace adopt | workspace | orchestrator | READ_ONLY | no | Analyze an existing repository without writing workspace files. | root --root default=PosixPath('.'); json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit workspace init | workspace | orchestrator | BOUNDED | yes | Plan or create a bounded operating-layer workspace. | root --root default=PosixPath('.'); name --name; project_type --type; profile --profile; execute --execute default=False; inject_ci --inject-ci default=False; inject_pre_commit --inject-pre-commit default=False; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit workspace dpa-intake | workspace | orchestrator | BOUNDED | yes | Run the deterministic DPA repository-intake orchestration. | root --root default=PosixPath('.'); validation_ref --validation-ref; output --output; write_evidence --write-evidence default=False; execute --execute default=False; require_ready --require-ready default=False; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit workspace upgrade | workspace | orchestrator | BOUNDED | yes | Plan or run deterministic workspace manifest schema upgrades. | root --root default=PosixPath('.'); execute --execute default=False; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit work start | work | orchestrator | BOUNDED | no | Start a human patch/slice workflow with the safe standard startup sequence. | branch --branch required; kind --kind default=patch; from_ref --from-ref default=main; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit work recover | work | orchestrator | BOUNDED | no | Run safe recovery/status commands after interrupted work. | json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit work rescue | work | orchestrator | BOUNDED | yes | Rescue local main work before realigning main to the local base ref. | execute --execute default=False; expected_signature --expected-signature; rescue_branch --rescue-branch; base_ref --base-ref default=origin/main; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit workflow go | workflow | orchestrator | BOUNDED | no | Request the configured workflow and run one bounded step. | project_root --root default=PosixPath('.') | 1.1.0 | a6ee797254ff |
agentic-kit transfer remote-work-start | transfer | orchestrator | BOUNDED | no | Prepare a remote work branch with freshness, status, and transfer safety checks. | branch branch required; main_branch --main-branch default=main; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit transfer remote-next | transfer | orchestrator | BOUNDED | no | Run the next repo-backed transfer order for local or remote work handoff. | branch branch; json_output --json default=False; allow_unlisted --allow-unlisted default=False | 1.1.0 | a6ee797254ff |
agentic-kit work finish | work | orchestrator | BOUNDED | yes | Finish a human work slice by planning or executing commit, push, PR, merge, and closeout checks. | branch --branch required; title --title required; message --message required; body --body; body_file --body-file; release_note_category --release-note-category; paths --path; merge_method --merge-method default=squash; merge --merge default=True; dry_run --dry-run default=True; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit transfer pr-create-complete | transfer | orchestrator | BOUNDED | no | Create, validate, merge, and optionally close out a PR without manual PR/SHA copying. | title --title required; body --body; base --base default=main; head --head default=current; merge_method --merge-method default=squash; timeout_seconds --timeout-seconds default=300; poll_seconds --interval-seconds/--poll-seconds default=10; post_merge_complete --post-merge-complete default=False; summary --summary default=False; json_output --json default=False; skip_llm_context_gate --skip-llm-context-gate default=False; release_note_category --release-note-category | 1.1.0 | a6ee797254ff |
agentic-kit transfer pr-complete | transfer | orchestrator | BOUNDED | no | Wait for CI, safely merge an existing PR, and synchronize main. | pr_number pr_number required; expected_head_sha --expected-head-sha; main_branch --main-branch default=main; merge_method --merge-method default=squash; timeout_seconds --timeout-seconds default=300; poll_seconds --interval-seconds/--poll-seconds default=10; summary --summary default=False; json_output --json default=False; skip_llm_context_gate --skip-llm-context-gate default=False; post_merge_complete --post-merge-complete default=False | 1.1.0 | a6ee797254ff |
agentic-kit transfer pr-closeout-complete | transfer | orchestrator | BOUNDED | no | Merge a substantive PR if needed, then finish post-merge handoff closeout. | after_pr --after-pr required; main_branch --main-branch default=main; merge_method --merge-method default=squash; timeout_seconds --timeout-seconds default=300; poll_seconds --poll-seconds default=10; merge_state_timeout_seconds --merge-state-timeout-seconds default=60; merge_state_poll_seconds --merge-state-poll-seconds default=5; summary --summary default=False; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit transfer post-merge-settle | transfer | orchestrator | DESTRUCTIVE | no | Deterministically settle post-merge generated-output refresh state. | after_pr --after-pr required; main_branch --main-branch default=main; merge_method --merge-method default=squash; ci_timeout_seconds --ci-timeout-seconds default=300; ci_poll_seconds --ci-poll-seconds default=10; merge_state_timeout_seconds --merge-state-timeout-seconds default=60; merge_state_poll_seconds --merge-state-poll-seconds default=5; refresh_limit --refresh-limit default=2; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit transfer post-merge-complete | transfer | orchestrator | DESTRUCTIVE | no | Run the post-merge handoff refresh lifecycle after a merged PR. | after_pr --after-pr required; main_branch --main-branch default=main; merge_method --merge-method default=squash; refresh_expected_head_sha --refresh-expected-head-sha; ci_timeout_seconds --ci-timeout-seconds default=300; ci_poll_seconds --ci-poll-seconds default=10; merge_state_timeout_seconds --merge-state-timeout-seconds default=60; merge_state_poll_seconds --merge-state-poll-seconds default=5; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit transfer chat-switch-complete | transfer | orchestrator | BOUNDED | no | Create a deterministic successor handoff package and prompt projections. | json_output --json default=False; render_prompt --render-prompt default=False; output_dir --output-dir; update_canonical_prompts --update-canonical-prompts default=True | 1.1.0 | a6ee797254ff |
agentic-kit transfer admin-refresh-pr | transfer | orchestrator | BOUNDED | no | Create or recover the administrative handoff refresh PR after a merged PR. | after_pr --after-pr required; main_branch --main-branch default=main; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit release ready | release | orchestrator | BOUNDED | no | Run release readiness through the standard-error scan wrapper. | version --version required; from_tag --from-tag; to_ref --to-ref default=main; date --date; summary_lines --summary-line; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit release prepare | release | orchestrator | BOUNDED | yes | Generate release summary evidence and run release-prep safely. | version --version required; from_tag --from-tag; to_ref --to-ref default=main; date --date; dry_run --dry-run default=True; summary_lines --summary-line; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit release run | release | orchestrator | BOUNDED | yes | Run the governed end-to-end release orchestrator with resumable approval gates. | version --version required; summary_lines --summary-line; execute --execute default=False; expected_signature --expected-signature; approved_by --approved-by; consent_source --consent-source; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit release-prep | root | orchestrator | BOUNDED | yes | Prepare release metadata through the supported agentic-kit route. | project_root --root default=PosixPath('.'); version --version required; release_date --date; summary_lines --summary-line; summary_lines_from --summary-lines-from; dry_run --dry-run default=False; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit release-publish | root | orchestrator | DESTRUCTIVE | yes | Plan release publishing without live tag/release side effects. | version --version default=1.1.0; dry_run --dry-run default=True; execute --execute default=False; allow_execute --allow-execute default=False; expected_signature --expected-signature; root --root default=PosixPath('.'); json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit post-release-doi-closeout | root | orchestrator | BOUNDED | no | Record verified DOI metadata after GitHub release and Zenodo publication. | project_root --root default=PosixPath('.'); version --version required; write --write default=False; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit docs lifecycle sweep | docs lifecycle | orchestrator | BOUNDED | yes | Build or apply a bounded documentation lifecycle sweep plan. | root --root default=PosixPath('.'); dry_run --dry-run default=True; only --only; until --until; review_after --review-after; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit dpa final-closeout-check | dpa | orchestrator | BOUNDED | yes | Validate the bounded DP1-DP5 final closeout record. | root --root default=PosixPath('.'); record --record default=PosixPath('docs/architecture/evidence/dpa/assessment/DPA_FINAL_CLOSEOUT_RECORD_20260801.json'); validation_ref --validation-ref; output --output; execute --execute default=False; output_json --json default=False; require_valid --require-valid default=False | 1.1.0 | a6ee797254ff |
agentic-kit workspace remove | workspace | orchestrator | BOUNDED | yes | Plan or remove exact Kit-generated operating-layer workspace files. | root --root default=PosixPath('.'); execute --execute default=False; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit artifact-gc | root | orchestrator | BOUNDED | yes | Dry-run by default garbage collector for transient communication artifacts. | tmp_logs --tmp-logs default=False; local_tmp --local-tmp default=False; local_tmp_contents --local-tmp-contents default=False; transfer_runs --transfer-runs default=False; report_retention --report-retention default=False; execute --execute default=False; ttl_seconds --ttl-seconds default=86400; older_than --older-than; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit github-create | root | orchestrator | BOUNDED | no | Create and push a GitHub repository for an initialized project. | project_root --root default=PosixPath('.'); owner --owner; visibility --visibility default=private | 1.1.0 | a6ee797254ff |
agentic-kit transfer evidence-pr-complete | transfer | orchestrator | BOUNDED | no | Finalize transfer evidence on an evidence branch and complete it through a PR. | slice_name --slice required; evidence_branch --evidence-branch required; title --title required; body --body; base --base default=main; run_log --run-log default=PosixPath('docs/reports/transfer_runs/latest-transfer-report.log'); remote_log --remote-log; scope --scope default=transfer; mode_check --mode-check default=standard; source_pr --source-pr default=NONE; ci --ci default=not-required; merge --merge default=not-required; command_report --command-report default=transfer lifecycle completed; interpretation --interpretation default=Evidence finalized through transfer evidence-pr-complete wrapper.; safe_step --safe-step default=Continue with the next planned slice.; merge_method --merge-method default=squash; timeout_seconds --timeout-seconds default=300; poll_seconds --interval-seconds/--poll-seconds default=10; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit transfer sync-main | transfer | orchestrator | BOUNDED | no | Synchronize main, acknowledge rules, and normalize the session. | main_branch --main-branch default=main; json_output --json default=False | 1.1.0 | a6ee797254ff |
agentic-kit chat session-start | chat | orchestrator | READ_ONLY | no | Render the session-start refresher and full inline command list. | mode --mode default=copy-paste | 1.1.0 | a6ee797254ff |
agentic-kit kit update | kit | orchestrator | BOUNDED | yes | Plan a released Kit update; signed execution installs locally, updates CI pins and checks the workspace. | version --version required; root --root default=PosixPath('.'); execute --execute default=False; expected_signature --expected-signature; json_output --json default=False | 1.1.0 | a6ee797254ff |