Home / Docs / Use SuperDevAI

Command line

The superdevai command runs the same agent from your terminal. It's included with the desktop app.

Where to run it

  • In the desktop app's built-in terminal, superdevai is ready to use and shares the app's sign-in and agent.
  • In Windows Terminal, run superdevai terminal install once to add a SuperDevAI profile (superdevai terminal remove takes it out again).

Sign in

superdevai login

Your browser opens to confirm a short code. The CLI keeps your sign-in for later runs. Inside the desktop app's terminal you're already signed in through the app.

An approved SuperDevAI account is required, including when you use your own model key. A run without one stops with a message asking you to sign in.

Run a task

superdevai "Fix: the dashboard shows yesterday's orders as due today"

The agent works in the current folder. It streams its progress, and in an interactive terminal it asks you to approve changes and commands as it goes.

Useful options

OptionWhat it does
--cwd <folder>Work in another folder.
--prompt-file <file>Read a long request from a file.
--mode simple|devSimple or Dev mode (default dev).
--approve edits|commands|all|noneApprove those actions automatically (default none: you're asked).
--yesSame as --approve all. Publishing, pushing to Git and deleting outside the project are never approved automatically: without a person to say yes, they are not done.
--conversation <id>Continue an existing conversation.
--model <connection/model>Use a specific model for this run.
--jsonMachine-readable output, for scripts.
--timeout <seconds>Stop waiting after this many seconds.
--diffShow each change as a diff while the run works.
--quiet, --verboseLess or more output.
--no-color, --color auto|always|neverControl colours.

Other commands

CommandWhat it does
superdevai historyRecent runs in this project (--limit <n>, default 20).
superdevai show <run-id>What a run did and what it changed.
superdevai rollback <task-id>Put files back the way they were before a task.
superdevai doctorCheck that the CLI, the agent and your sign-in are working.
superdevai config show / set / editView or change CLI settings, such as the default model.
superdevai rules listShow the project rules the agent follows here.
superdevai versionPrint the version.

Run superdevai --help for the full list.