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,
superdevaiis ready to use and shares the app's sign-in and agent. - In Windows Terminal, run
superdevai terminal installonce to add a SuperDevAI profile (superdevai terminal removetakes 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
| Option | What it does |
|---|---|
--cwd <folder> | Work in another folder. |
--prompt-file <file> | Read a long request from a file. |
--mode simple|dev | Simple or Dev mode (default dev). |
--approve edits|commands|all|none | Approve those actions automatically (default none: you're asked). |
--yes | Same 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. |
--json | Machine-readable output, for scripts. |
--timeout <seconds> | Stop waiting after this many seconds. |
--diff | Show each change as a diff while the run works. |
--quiet, --verbose | Less or more output. |
--no-color, --color auto|always|never | Control colours. |
Other commands
| Command | What it does |
|---|---|
superdevai history | Recent 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 doctor | Check that the CLI, the agent and your sign-in are working. |
superdevai config show / set / edit | View or change CLI settings, such as the default model. |
superdevai rules list | Show the project rules the agent follows here. |
superdevai version | Print the version. |
Run superdevai --help for the full list.