Parton CLI is in early alpha (v0.1.0)

Things may break or change between releases. We don't recommend using Parton on production projects yet. If you run into anything unexpected, we'd genuinely appreciate your feedback — it helps us make Parton better for everyone.

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:

  1. Setup gate checks whether model access is configured.
  2. Setup runs if needed.
  3. Clarification asks a few questions if the intent is ambiguous.
  4. Planning builds waves and lanes.
  5. Execution applies changes.
  6. Final validation runs on the full repo.
  7. Repair fixes validation failures if needed.
  8. 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.

Next steps