CLI Reference
This page documents the main user-facing Parton commands.
parton help
Show help for Parton or a specific command.
parton help
parton help run
Use this to discover commands, options, and examples.
parton version
Show the installed Parton version.
parton version
Useful when debugging install or upgrade issues.
parton update
Update Parton to the latest version.
parton update
parton update --check
--check — Only check for a new version without installing.
Downloads the correct binary for your platform from GitHub and replaces the current binary atomically. See the update guide for details.
parton setup
Run the setup flow manually.
parton setup
Use this when:
- you want to configure model access before your first run
- you want to switch providers
- you want to reconfigure stage models
parton doctor
Validate that your local setup is ready.
parton doctor
Doctor checks:
- provider access
- selected model availability
- validation commands
- writable local runtime state
parton run
Run a task end-to-end.
parton run "add auth to the app"
parton run "create todo app"
What run does
A run may include:
- setup gate
- clarification
- planning
- execution
- final validation
- repair
- final review
Common flags
parton run "create todo app" --review-plan
parton run "add auth" --clarify
parton run "add auth" --no-clarify
--review-plan — Pause before execution and open the plan for review.
--clarify — Force the clarification phase.
--no-clarify — Skip clarification and proceed with assumptions.
Greenfield behavior
If you run in an empty folder, Parton can enter greenfield mode and scaffold a project from scratch.
Example:
mkdir my-app
cd my-app
parton run "create todo app"
parton resume
Resume a paused run.
parton resume <run_id>
Use this when a run was paused because of:
- provider outage
- network drop
- rate limit
- temporary quota exhaustion
parton plan
Generate a plan without running execution.
parton plan "add auth to the app"
This is useful when you want to inspect the plan before making changes.
If your prompt is ambiguous, setup and clarification rules may still apply.
parton status
Show run status.
parton status
parton status <run_id>
Use this to inspect current or recent runs.
parton logs
Inspect logs and artifacts for a run.
parton logs <run_id>
Use this when debugging:
- execution problems
- validation failures
- repair escalation
- provider issues
Typical workflow
parton setup
parton doctor
parton run "create todo app"
Or for an existing repo:
parton run "add email field to user and update all usages"
Notes
- Commands that require AI will not run until setup is complete.
- Parton may ask clarification questions before planning.
- At the end of a run, Parton prints a local review URL.