← neotheapp.comNeo GuideNeo CLI

Neo CLI guide

Version 0.9.6 · macOS, Linux and Windows

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 | bash

Keep 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

  1. Download neo_0.9.6_windows_amd64.zip.
  2. 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
  3. 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"
  4. 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.
  5. 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:

neo

The 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 --status

Connect 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.

CommandWhere to get the keyWhat it gives you
neo keys set claudeconsole.anthropic.com, API keysClaude
neo keys set openaiplatform.openai.com, API keysCodex and the ChatGPT models
neo keys set geminiaistudio.google.comGoogle Gemini
neo keys set openrouteropenrouter.aiOne 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 keys

Free, 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.

  1. Install Ollama from ollama.com.
  2. Download a coding model:
    ollama pull qwen3-coder:30b
  3. 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
  4. Send it work:
    neo task "make a simple landing page for a bakery" --project 1

Make your first thing

  1. Run neo to open the chat.
  2. Type what you want, in plain words. For example: make a landing page for a bakery.
  3. Neo answers with its suggestion: what it plans to make, and how.
  4. Type /go and 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.
  • /open opens the preview or a file Neo made. /details on shows every step Neo takes.
  • /model picks 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 web

It 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.

CommandWhat 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
/stopStop 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
/readyThe big packages and how far their downloads are (the same as neo ready)
/updateInstall the newest neo and server (the same as neo update)
/statusServer, model, project and AI connections at a glance
/feedback [bug | feature] <text>Send feedback to the Neo team
/uiWhat you can open in a browser
/details on|offShow or hide every step Neo takes
/new, /quitStart 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
PresetWho does the workGood for
/team preset freeEverything runs on your computer. No key, no bill.Simple websites only, and slowly. You check each task yourself.
/team preset economyOne OpenRouter key runs the whole team for cents.Small sites and simple apps. Not for 3D games.
/team preset balancedClaude Opus plans and checks, Gemini 3.1 Pro writes the code. The default.Most work. Quality stays close to Opus alone.
/team preset bestClaude 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 codeMeaning
0Done
1Failed
2Neo asked something first (a card), and nothing ran
3A 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 too

A 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.

SystemFolder
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 logs

Updates

One command installs the newest version on Mac, Linux and Windows, and renews the server too:

neo update

In 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 status then start it with neo server start and neo server logs shows why it stopped.
A tool Neo needs is missing
neo setup checks everything, and neo setup --fix installs 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 web again.
"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.