Neo CLI guide
Neo, in your terminal. On Windows and Linux the CLI is the whole of Neo. On a Mac it is a second way in, next to the app. You say what you want in plain words, and Neo builds it. This guide takes you from the install to the first thing you make.
Install
What you need
- Python 3.10 or newer (from python.org). On Windows, tick Add python.exe to PATH in the Python installer.
- git (from git-scm.com).
Neo installs everything else by itself the first time it needs it.
Mac and Linux
Open a terminal and paste this line:
curl -fsSL https://dl.neodl.app/cli/install.sh | bashKeep bash at the end, not sh: on Debian and Ubuntu, sh cannot run the installer. The installer picks the right download for your computer, checks it against the release's checksums, and puts neo in ~/.local/bin.
If the terminal then says it cannot find neo, open a new terminal window and try again.
Windows
- Download neo_0.9.6_windows_amd64.zip.
- Optional, but wise: check the download. In PowerShell, in the folder you downloaded to, run the line below. The SHA-256 it shows must match the zip's line in checksums.txt.
Get-FileHash .\neo_0.9.6_windows_amd64.zip - Unzip it into
%LOCALAPPDATA%\Programs\Neo. These two lines make the folder and unzip into it:New-Item -ItemType Directory -Force "$env:LOCALAPPDATA\Programs\Neo" Expand-Archive -Force .\neo_0.9.6_windows_amd64.zip "$env:LOCALAPPDATA\Programs\Neo" - Add that folder to your PATH: open Start, type environment variables, choose Edit environment variables for your account, select Path, then New, paste the folder and press OK.
- Open a new terminal (PowerShell or Windows Terminal) and run
neo.
If Windows SmartScreen says it protected your PC, choose More info, then Run anyway. The CLI is not signed yet.
First run and sign in
Type this and press Enter:
neoThe first time, Neo sets up its server on your computer. It takes a few minutes and happens only once. The server runs on your own machine, so your code and keys stay with you. The CLI finds it by itself.
Then Neo asks for your email. We send you a 6 digit code from hello@wipoai.tech. Type it in and Neo opens. Your sign in renews itself after that.
You can sign in again at any time, or see until when you are signed in:
neo signin
neo signin --statusConnect an AI with your own key
Neo works with your own API key, so the AI company bills you directly for what you use. Pick one to start; you can add more later.
| Command | Where to get the key | What it gives you |
|---|---|---|
neo keys set claude | console.anthropic.com, API keys | Claude |
neo keys set openai | platform.openai.com, API keys | Codex and the ChatGPT models |
neo keys set gemini | aistudio.google.com | Google Gemini |
neo keys set openrouter | openrouter.ai | One key for many models |
Neo asks for the key with hidden typing, keeps it in the Neo server on your computer and never prints it. To see which keys are set (never their values):
neo keysFree, on your own computer: Ollama
No key and no bill: a local model runs on your own computer. It needs a strong machine with plenty of memory, and it is slower than a cloud model.
- Install Ollama from ollama.com.
- Download a coding model:
ollama pull qwen3-coder:30b - Give your project an agent that uses it. The first line adds the agent and shows its id; put that id in the second line.
neo agents add --project 1 --template "Local Coder" neo agents edit <id> --provider ollama --model qwen3-coder:30b - Send it work:
neo task "make a simple landing page for a bakery" --project 1
Make your first thing
- Run
neoto open the chat. - Type what you want, in plain words. For example: make a landing page for a bakery.
- Neo answers with its suggestion: what it plans to make, and how.
- Type
/goand Neo builds it with those picks. You see short progress lines, and a preview link at the end.
$ neo
Neo chat · claude/opus · no project. Type a message, /help for commands, /quit to leave.
neo> make a landing page for a bakery
Your website, Neo's suggestion
What kind of site: Landing page
...
/go builds it with these picks (the app lets you change each one).
neo> /go
Neo is on it: Web with claude opus
· Writing the pages
· Trying it out
Preview: https://...Good to know
- Anything that costs money or goes outside your computer asks first:
Allow it? [y/N]. - Ctrl+C stops a running turn. Tab completes commands, and the arrow keys bring back earlier lines.
/openopens the preview or a file Neo made./details onshows every step Neo takes./modelpicks the AI, and Neo remembers it per project: claude (your Anthropic key), codex (your OpenAI key), gemini (your Google key) or neo (Neo's own agents, with your keys or a local Ollama model).
Neo in a window
Prefer clicking to typing? This opens Neo's window: your projects, the chat, the live preview, Discover, Sketch and Settings.
neo webIt opens in Chrome or Edge as an app window, or else in your usual browser. On Windows and Linux it opens right away. On a Mac where the Neo app is installed, the app asks once, A new app wants access to Neo; allow it.
The window's address works only once and only for a short time, so open it with neo web each time instead of a bookmark. neo web --print prints the address instead of opening it.
A few screens are still on their way to the window. The CLI already has most of them; neo help lists everything.
Slash commands
Inside the chat, a line that starts with / is a command. /help lists them all, and /help <command> shows an example.
| Command | What it does |
|---|---|
/help [command] | All commands in groups; with a command, how to use it and an example |
/model [provider/model] | List the models and whether each is ready; pick one |
/project [list | use <name or #> | new <name> | none] | Choose the project the chat works on |
/go [choice] | Accept Neo's last suggestion and start |
/stop | Stop the running turn |
/open [n | url] | Open a preview or a file the chat made |
/approve [id] [choice], /deny [id] | Answer a card that asks for your OK |
/team [list | show | mode on|off | preset <name> | coder <model> | log] | The project's team and Team mode (see below) |
/pipeline [list | start <id> | status [run] | resume <run> | stop <run>] | Ready made chains of work: launch, app, game, content |
/game [list | use <name> | pipeline | template <t> | idea <text> | run [step] [--all] | next] | Make a game step by step; free steps run here, a paid step asks first |
/keys [set <name>] | Which keys are set (never their values); add one with hidden typing |
/setup [fix [tool ...]] | Check the tools Neo uses; install what is missing |
/ready | The big packages and how far their downloads are (the same as neo ready) |
/update | Install the newest neo and server (the same as neo update) |
/status | Server, model, project and AI connections at a glance |
/feedback [bug | feature] <text> | Send feedback to the Neo team |
/ui | What you can open in a browser |
/details on|off | Show or hide every step Neo takes |
/new, /quit | Start a new conversation; leave |
To send a message that itself starts with /, type // at the start.
Team mode
In Team mode a strong Lead model plans the work and checks every task, and a cheaper Coder model writes the code. You pay less than with the strong model alone, and the Lead's reviews keep the quality up.
/team mode on
/team preset balanced
/team log
/team mode off| Preset | Who does the work | Good for |
|---|---|---|
/team preset free | Everything runs on your computer. No key, no bill. | Simple websites only, and slowly. You check each task yourself. |
/team preset economy | One OpenRouter key runs the whole team for cents. | Small sites and simple apps. Not for 3D games. |
/team preset balanced | Claude Opus plans and checks, Gemini 3.1 Pro writes the code. The default. | Most work. Quality stays close to Opus alone. |
/team preset best | Claude Opus leads, Claude Sonnet writes the code. | The strongest Coder. Costs more than Balanced. |
/team coder <model> swaps in a Coder of your choice. /team log shows the team's tasks, results and reviews.
When the Coder gets stuck on a task, or a run reaches its spending limit, Neo stops and asks with a card. Answer with /approve and one of these choices (leave out the id to answer the latest card):
/approve lead: the Lead finishes the task itself. It costs more, but it gets done./approve retry: one more try with the Coder./approve more: allow a little more spending for this run and go on./deny: stop here and keep the tasks that are already done.
Scripts and CI
Every job can also run once, without the chat, so you can use Neo in scripts and CI. The exit code tells the script what happened:
| Exit code | Meaning |
|---|---|
0 | Done |
1 | Failed |
2 | Neo asked something first (a card), and nothing ran |
3 | A paid step, or one that goes outside your computer, waits for a person |
neo ask "write release notes for v1.2" --model claude/sonnet
neo ask "make a landing page for a bakery" --go --json # --go accepts Neo's own picks
neo pipeline run launch --project 3 # a ready made chain, followed to its end
neo pipeline status
printf '/project list\n/quit\n' | neo chat # the chat reads a script tooA script never approves a paid step by itself. neo ask turns approval cards down unless you add --approve ask on a terminal, and neo pipeline run goes past a paid step only with --approve.
--json prints one object with ok, command, result, calls and error. For neo ask, the result holds the status, the run id, the answer, the progress lines, previews, files and any approvals still waiting.
Where your files are
Neo keeps everything in one home folder: its database, your keys, the projects it makes, and its server.
| System | Folder |
|---|---|
| macOS | ~/.neo |
| Linux | ~/.local/share/neo (or $XDG_DATA_HOME/neo) |
| Windows | %LOCALAPPDATA%\Neo |
Set NEO_HOME to move it somewhere else. An update replaces only the server's code, so your work is never touched.
The server that runs on your computer has its own commands:
neo server status
neo server start
neo server stop
neo server logsUpdates
One command installs the newest version on Mac, Linux and Windows, and renews the server too:
neo updateIn the chat, /update does the same, and the chat tells you once a day when a newer version is out. neo update --check only looks. The neo that comes with the Mac app updates with the app.
Older than 0.9.4? Update once by hand: on Mac and Linux run the install line again; on Windows unzip the new zip over the old folder and run neo server setup. Then neo server restart.
Your projects, keys and sign in stay where they are.
Feedback
Something broke, or you have an idea? Tell us. You can also type /feedback in the chat.
neo feedback submit "what happened"
neo feedback submit "the preview never opened" -c bug --severity blocking-c bug --severity blocking marks how bad it is. Neo tells you plainly whether the report was sent or kept on your computer to send later. You can also write to hello@wipoai.tech.
Troubleshooting
- The terminal says it cannot find
neo - Open a new terminal window. On Windows, check that the Neo folder is in your PATH (step 4 of the install).
- The first run says Python is missing
- Install Python 3.10 or newer from python.org. On Windows, tick Add python.exe to PATH, then open a new terminal.
- "Neo is not signed in yet"
- Run
neo signin - "Neo is not answering right now"
- Check the server with
neo server statusthen start it withneo server startandneo server logsshows why it stopped. - A tool Neo needs is missing
neo setupchecks everything, andneo setup --fixinstalls what is missing. A few tools only you can install; Neo lists them with a download link.- "Waiting for approval in the Neo app" on Windows or Linux
- Your neo is an older version. Update it (see Updates above).
- The window says "Open Neo from your computer"
- It was opened from a bookmark, a reload in a new tab, or an old address. Run
neo webagain. - "This needs Neo Cloud" in Showroom, Community or News
- You are probably not signed in. Check with
neo signin --status - Nothing happens after
neo task - The project needs an agent with a model. See which agents it has with
neo agents list --project 1
Something missing or unclear? Send it with neo feedback submit, or write to hello@wipoai.tech.