Quickstart
Get Parton installed, configured, and running your first task in a few minutes.
1. Install Parton
curl -fsSL https://parton.run/install.sh | sh
2. Verify the install
parton version
parton help
If parton is not found, make sure your install directory is in your PATH.
3. Enter a project folder
For an existing repo:
cd my-project
For a new project:
mkdir my-app
cd my-app
4. Run your first task
For an existing project:
parton run "add email field to user and update all usages"
For a new project:
parton run "create todo app"
What happens next
Parton runs a full workflow:
- Setup gate checks whether model access is configured.
- Setup runs if needed.
- Clarification asks a few questions if the intent is ambiguous.
- Planning builds waves and lanes.
- Execution applies changes.
- Final validation runs on the full repo.
- Repair fixes validation failures if needed.
- Review opens a local browser page with the result.
Example CLI flow
→ setup required...
→ planning...
→ executing...
→ validating...
→ repairing (1/3)...
→ success
Review the result
At the end of a run, Parton prints a local review URL, for example:
http://localhost:4317/runs/<run_id>/review
Open that page to inspect the diff and final result.