Command line

CodeStilt in your terminal

Run tasks from the command line or in scripts and CI, with the same plans, danger wall and undo as the apps.

On Windows, download codestilt-windows-amd64.exe from the download page.

Terminal

$ codestilt link
Linked to you@example.com as "Office laptop".
$ codestilt allow .
$ codestilt task "add a dark mode toggle"
PLAN: Add a dark mode toggle to the header
Estimated cost: about 4.0 credits
Approve this plan? [Enter = yes, n = no]
  - Tests passed (9 of 9)
Done. Used 3.10 credits. Undo within 7 days with: codestilt undo 43

What you get

Built for developers

Interactive or scripted

Approve plans with Enter, or use --yes for plans with no risky steps.

Same danger wall

The same rules as the desktop app, on every machine.

Undo

codestilt undo NUMBER puts a task's files back.

Pick a model

--model auto, best, fast or saver on any command.

Status

codestilt status shows your account, folders and connection.

Pause anytime

codestilt pause stops all work on this computer.

Get started

Install

macOS and Linux: curl -fsSL https://codestilt.com/install.sh | sh. Windows: download codestilt-windows-amd64.exe from the download page and rename it to codestilt.exe.

Link your computer

codestilt link opens your browser to confirm.

Run a task

codestilt allow . then codestilt task "add a dark mode toggle"

Commands

Command reference

Command	What it does
`codestilt`	Open the desktop app (the control panel in your browser).
`codestilt link`	Link this computer to your account. Opens your browser to confirm.
`codestilt allow FOLDER`	Let CodeStilt work in a folder. `.` means the current folder.
`codestilt disallow FOLDER`	Stop CodeStilt working in a folder.
`codestilt folders`	List allowed folders.
`codestilt task "..."`	Start a task in the current folder, show the plan, Enter approves.
`codestilt undo NUMBER`	Put a task's files back as they were.
`codestilt agent`	Run without the control panel, for servers and background use.
`codestilt status`	Account, folders, connection and latest version. Add `--json` for scripts.
`codestilt pause` / `resume`	Pause or resume all work on this computer.
`codestilt startup on\|off`	Start CodeStilt when you sign in to your computer.
`codestilt unlink`	Remove this computer from your account.
`codestilt version`	Show the version.

In practice

Interactive when you want it, scriptable when you need it

Approve with Enter

codestilt task shows the full plan in your terminal: the steps, the files it may touch and the estimated credits. Press Enter to approve or n to say no, then watch the steps and test results.

--model auto|best|fast|saver on any task
Same danger wall and checkpoint as the apps
Undo command printed at the end

Terminal

$ codestilt task --model fast "rename getUser to fetchUser"
Task started: https://app.codestilt.com/tasks/51

PLAN: Rename getUser to fetchUser everywhere
  1. Rename the function in src/api/user.js
  2. Update the 4 places that call it
  3. Run the tests
Estimated cost: about 2.0 credits

Approve this plan? [Enter = yes, n = no]
  - Checkpoint saved, everything can be undone
  - Tests passed (31 of 31)
Done. Undo within 7 days with: codestilt undo 51

Run it on a server

On a build machine or a remote server, link once and run codestilt agent to wait for tasks without the control panel. Give tasks from the dashboard or your phone and they run there.

--yes approves only plans with no risky steps
Risky plans must still be approved in the dashboard
codestilt status --json for health checks

Terminal

$ codestilt link
Linked to you@example.com as "build-server".
$ codestilt allow /srv/shop
$ codestilt status --json
{"linked": true, "name": "build-server", "folders": ["/srv/shop"], ...}
$ codestilt agent
Waiting for tasks. Press Ctrl+C to stop.

CLI questions

Straight answers to the questions people ask us most.

Is the CLI a different product from the desktop app?

No. It is the same program. Running codestilt with no command opens the control panel; with a command it works in the terminal. Same account, rules and undo.

Does --yes skip the danger wall?

No. --yes only approves plans that have no risky steps. Every command is still checked, never-allowed commands are still refused, and plans with risky steps must be approved in the dashboard.

How do I install it on Windows?

Download codestilt-windows-amd64.exe (or ARM64) from the download page, rename it to codestilt.exe, put it in a folder on your PATH and run it from a terminal.

Does the install script check the download?

Yes. It downloads the right program for your system, checks its SHA-256 against our published list, and installs it to ~/.local/bin/codestilt.

Can I use it in CI?

You can run tasks from scripts with --yes for plans without risky steps. Because the approval is the point of CodeStilt, anything risky always waits for a person.

Start free. No card needed.

Download CodeStilt, link your computer, and give your first task in two minutes.

Download CodeStilt Open web app