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.

CLI Reference

This page documents the user-facing Parton commands.

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 executes the full pipeline:

  1. Setup gate
  2. Clarify
  3. Plan (skeleton)
  4. Scaffold + Enrich (parallel)
  5. Structure Check
  6. Final Execution (parallel)
  7. Validation + Auto-fix

Flags

parton run "create todo app" --review
parton run "add auth" --verbose

--review — Force a plan review pause before execution begins.

--verbose — Enable debug logging output.

Greenfield behavior

If you run in an empty folder, Parton enters greenfield mode and scaffolds a project from scratch.

mkdir my-app
cd my-app
parton run "create todo app"

parton setup

Run the setup TUI 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 per-stage models

The setup TUI has four tabs: Default, Planning, Execution, and Judge.

parton version

Show the installed Parton version.

parton version

Useful when debugging install or upgrade issues.

Typical workflow

parton setup
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.
  • Analysis of the codebase happens automatically on first run — there is no separate analyze command.

Related