Install
One command on macOS, Linux or Windows. It brings its own Node.js and asks for no password.
Install
In a terminal, on macOS or Linux (arm64 or x64):
curl -fsSL https://engenty.ai/install.sh | bashOn Windows 10 or 11, in PowerShell:
irm https://engenty.ai/install.ps1 | iexOr, with Node.js 20 or newer on the machine:
npx wizardsAll three do the same. On Windows, if PowerShell refuses npx (“running scripts is disabled
on this system”), type npx.cmd wizards. npx wizards downloads only a small launcher (no
dependencies) and runs the installer it brings along, then the setup, then the
wizards menu, where “Start as service” starts it and opens the studio. Run again, it hands over
to the installed wizards, and brings an older install up to its own version first.
The installer needs nothing but curl and tar. On Windows it needs nothing, except Microsoft’s
Visual C++ runtime, which many programs bring along: where it is missing, the installer installs
it, and Windows asks once whether it may. It brings its own Node.js
(a Node you already have is left alone), installs engenty wizards into ~/.engenty/wizards
(about 650 MB), links the wizards command into ~/.local/bin (on Windows it puts
~\.engenty\wizards\bin on your PATH) and then walks you through the rest:
| Step | What it does |
|---|---|
| Your engenty account | Asks “Sign in or create your account now?”. If you say yes, it shows a link and a code and opens your browser for the sign-in at account.engenty.ai; check that the page shows the same code (if you have no account yet, the page creates one with your invitation code, or puts you on the waitlist). While it waits, Enter opens the page again and Esc goes on without an account. Once you are signed in, what you publish on this computer runs in the cloud too. If you say no, wizards account sign-in does it any time. Setting it up again with --local signs an account out. --local leaves the account out altogether: see Local only |
| An AI client | Looks for Codex, Claude Code, Antigravity and Cursor Agent and offers to install the ones that are missing. It puts first the one whose app (ChatGPT, Claude, Antigravity, Cursor) is on your Mac, as you most likely have that subscription already. You can also use your account’s credits, an API key, Ollama or, on a Mac with Apple silicon and macOS 26, Apple Intelligence: the studio’s first page offers them |
| A browser and ffmpeg | Names the browser for PDF and PNG exports and steps on websites: the first of Chrome, Edge and Chromium it finds (on a Mac also Brave). engenty wizards uses that one; CHROME_PATH picks another. It also says whether ffmpeg is there for MP4 videos of animated widgets, and with Homebrew it offers to install it |
| A decision model (optional) | Offers to install Ollama if it isn’t there and to download Cloudflare’s Clef-flash into it (about 11 GB). The wizards then make their decisions, such as which branch to take, on your computer, without a key or credits. On a Mac the Ollama app goes into Applications and, when it first starts, asks once for your Mac’s password to set up its ollama command (cancel works too); on Linux Ollama’s own installer runs, installs zstd if it is missing, and asks for your password |
| Start at login (optional) | engenty wizards starts in the background when you log in, so links and AI apps can always reach it. It is a LaunchAgent on a Mac, a systemd user service on Linux and a scheduled task on Windows (a shortcut in the Startup folder where Windows allows no task) |
| Your AI apps (optional) | Offers to add your wizards to the AI apps it finds, such as Claude Desktop, Cursor or Codex |
| The command | If ~/.local/bin is not on your PATH, it offers to add it in your shell’s settings file |
The installer starts nothing. At the end it says whether engenty wizards is running and how to
start, stop and check it. You install once; from then on you use the wizards command.
Start, stop, check
| Command | What it does |
|---|---|
wizards start | Starts it and opens the studio. It runs while that terminal is open; Ctrl-C stops it |
wizards start -s | Starts it in the background, so the terminal stays free |
wizards studio | Opens the studio. If engenty wizards isn’t running, it starts it in the background first |
wizards stop | Stops it. Your data is kept |
wizards status | Shows whether it is running, and where |
wizards restart | Stops it and starts it again |
wizards account | Shows the account this computer is signed in to; sign-in and sign-out change it |
wizards | Opens a menu with all of it |
The studio is at http://localhost:24368/studio/. The link the command opens signs this browser
in, and it works once. For another browser, see wizards open.
If the command is not found, open a new terminal or run ~/.local/bin/wizards.
Install it as an app
In Chrome or Edge you can install the studio as an app, with its own window and its own icon in the Dock or taskbar. The studio offers it in a banner at the top, or you click the install icon at the right of the address bar.
Other ways to get it
| Way | For |
|---|---|
| From source | Working on the code |
| Docker | A server others can reach |
Update
engenty wizards updates itself: it looks for a new version when it starts and once a day,
downloads it in the background and checks it, and switches to it at the next start (a restart or
the next login), never while a wizard runs. The version before stays beside it. wizards status
and the studio then say “Updated to …” with what changed. To turn it off:
wizards autoupdate offor set WIZARDS_DISABLE_AUTOUPDATE=1 (in the terminal or in ~/.engenty/wizards/.env). In CI,
and for an install set up without a terminal, it is off unless you turn it on with wizards autoupdate on. npx wizards never updates itself. To update now:
wizards updateThis runs the installer again without its questions. If engenty wizards is running, wizards restart then starts the new version; the command tells you so. "Update" in the wizards menu
restarts it into the new version by itself.
The studio also tells you in a banner at the top when a new version is out (“Version … of engenty wizards is out.”). “Update” there installs it and starts the new version. The About dialog behind the engenty mark in the app bar shows the same, and so does the line at the top of Settings → Account: its version number opens the About dialog with what is new. Your data is brought up to date at the next start.
Remove
wizards uninstallFirst it shows what it will remove: your wizards in your AI apps, starting at login, everything of
engenty wizards that is running, the program in ~/.engenty/wizards and the command
~/.local/bin/wizards. Your data in ~/.engenty/wizards/data is kept unless you say to delete
it, and installing again picks it up. Back it up first if you delete it. At the end
it lists anything it couldn’t remove.
If the wizards command is no longer on your path, npx wizards uninstall hands over to the
installed one.
| Option | What it does |
|---|---|
--dry-run | Only shows what it would remove |
--yes | Removes everything without asking and keeps your data |
--yes --delete-data | Deletes your data as well |
Without a terminal, it asks for --yes.