CLI commands
kipp•punkt provides two CLI commands: start to launch the orchestrator, and ingress to load tasks into a running orchestrator.
Starts the main orchestrator. On launch, it begins polling for work and assigning tasks to agents.
kipppunkt-agent start --command "<template>" [options]Stop with Ctrl+C. The orchestrator persists state and resumes on next start.
Options
Section titled “Options”--command (required)
Section titled “--command (required)”Agent command template. See AI harness commands.
--config-path
Section titled “--config-path”Default: .kipppunkt/config.json
Path to the configuration file.
--log-level
Section titled “--log-level”Default: info
Log verbosity: error, warn, info, or debug.
--retry-failed
Section titled “--retry-failed”Default: false
Reset all failed tasks to idle on startup.
--orchestrator-url
Section titled “--orchestrator-url”Default: http://localhost:2309
URL of the orchestrator API endpoint.
--shutdown-on-task-failed
Section titled “--shutdown-on-task-failed”Default: false
Gracefully shut down when a task enters failed state.
AI harness commands
Section titled “AI harness commands”The --command flag accepts a template string with a {prompt} placeholder that the orchestrator replaces at runtime.
| Harness | Command template |
|---|---|
| Codex | codex exec {prompt} --dangerously-bypass-approvals-and-sandbox |
| Claude Code | claude -p {prompt} --dangerously-skip-permissions |
| OpenCode | opencode run {prompt} |
| Copilot CLI | copilot -p {prompt} |
ingress
Section titled “ingress”Loads tasks into a running orchestrator from a requirements JSON file. The orchestrator must already be running.
kipppunkt-agent ingress --requirements <requirements.json> [options]Options
Section titled “Options”--requirements (required)
Section titled “--requirements (required)”Path to the requirements JSON file.
Default: http://localhost:2309
URL of the orchestrator API endpoint.
See Requirements file ingress for details on the file format.