FeaturesHow It WorksPricingDocsInstallContact UsGitHub

Parton CLI is in early alpha

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

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 pipeline automatically:

  1. Setup gate — checks whether model access is configured. Launches the setup TUI if needed.
  2. Clarify — asks a few questions if the intent is ambiguous.
  3. Plan (skeleton) — builds a structured plan with per-file contracts, dependency installs, and validation commands.
  4. Scaffold + Enrich (parallel) — config files are finalized during scaffold; logic files are generated in parallel with full context.
  5. Structure Check — runs the plan's check_commands to verify project structure.
  6. Final Execution (parallel) — all remaining logic files are generated simultaneously.
  7. Validation + Auto-fix — runs the plan's validation_commands (build, lint, test). If validation fails, Parton re-generates failing files with error context automatically.

Example CLI flow

→ setup required...
→ clarifying...
→ planning...
→ scaffolding...
→ executing...
→ validating...
→ auto-fixing (1/3)...
→ success

Next steps