[ Install ]

Get Dragon Code Running in 2 Minutes

Only 3 steps to install Dragon Code, our frontier terminal agent. Runs natively on macOS, Linux, and Windows — no WSL required.

Install

Never used a terminal before? On macOS or Linux, open the Terminalapp (search “Terminal”). On Windows, open PowerShell(search “PowerShell” in the Start menu). To run a command below: click its copy icon, click inside the terminal window, paste (Cmd+V or Ctrl+V), and press Enter.

Pick your operating system, then run oneof the commands shown — you only need one, not all of them.

Before you start

Nothing to install first — Terminal, curl, and unzip all ship with macOS. Works on Apple Silicon and Intel.

Option A · One-line install (recommended)

curl -fsSL https://raw.githubusercontent.com/VELLORAAI/dragoncode-public-dist/main/install | bash

or

Option B · Homebrew

brew install velloraai/tap/dragon

If macOS blocks it on first run

If you see “dragon can't be opened because Apple cannot check it,” clear the quarantine flag once (the binaries aren't notarized yet), then run dragon again:

xattr -d com.apple.quarantine "$(command -v dragon)"

Run dragon

Whichever command you ran above, the rest is the same. First, open a new terminal window so your computer can find the dragon command. (On macOS or Linux you can instead run source ~/.zshrc— or your shell's rc file — in the window you already have.)

Check it installed — this should print a version number:

dragon --version

Then launch it and press Enter:

dragon

That launches Dragon Code. The first time you run it, it'll ask for an API key. That's the last step.

Add your API key

When dragon starts, it asks for your MWS API key. Here's how to get one:

Sign up and get a key →

Already have an account?

Grab a key from your dashboard

Paste it in (Cmd+V or Ctrl+V), press Enter, and you're coding.

Every platform, in full

Prefer to see everything at once? The complete steps for every OS, no clicking — deep-linkable at #macos, #linux, and #windows.

macOS

Before you start

Nothing to install first — Terminal, curl, and unzip all ship with macOS. Works on Apple Silicon and Intel.

Option A · One-line install (recommended)

curl -fsSL https://raw.githubusercontent.com/VELLORAAI/dragoncode-public-dist/main/install | bash

or

Option B · Homebrew

brew install velloraai/tap/dragon

If macOS blocks it on first run

If you see “dragon can't be opened because Apple cannot check it,” clear the quarantine flag once (the binaries aren't notarized yet), then run dragon again:

xattr -d com.apple.quarantine "$(command -v dragon)"

Linux

Before you start

You need curl and tar— most distros already have them. On a minimal Debian or Ubuntu image:

sudo apt-get install -y curl

Option A · One-line install (recommended)

curl -fsSL https://raw.githubusercontent.com/VELLORAAI/dragoncode-public-dist/main/install | bash

or

Option B · Homebrew

brew install velloraai/tap/dragon

Works on x64 and arm64 glibc distros (Ubuntu, Debian, Fedora, Arch, and more). Alpine / musl isn't supported yet.

Windows

Before you start

Nothing to install first — PowerShell is built into Windows 10 and 11. No WSL, no Ubuntu, and no admin rights needed.

Option A · PowerShell (recommended)

irm https://raw.githubusercontent.com/VELLORAAI/dragoncode-public-dist/main/install.ps1 | iex

Installs to %USERPROFILE%\.dragoncode\bin and adds it to your PATH. On Windows on ARM it installs the x64 build, which runs under emulation.

If Windows shows “Windows protected your PC” the first time you run dragon, click More info then Run anyway— the binaries aren't code-signed yet.

or

Option B · Git Bash or WSL

curl -fsSL https://raw.githubusercontent.com/VELLORAAI/dragoncode-public-dist/main/install | bash

Run this inside Git Bash or your WSL terminal — not PowerShell.

Don't have WSL yet? It's optional — PowerShell above is simpler. But if you want it, one-time setup, then reopen your terminal:

wsl --install -d Ubuntu

Troubleshooting

dragon: command not found

The installer put Dragon on your PATH (~/.dragoncode/bin, or %USERPROFILE%\.dragoncode\binon Windows), but terminals that were already open don't know about it yet. Open a new terminal windowand try again — on macOS or Linux you can instead run source ~/.zshrc(or your shell's rc file).

Windows: “Windows protected your PC”

SmartScreen warns about apps it hasn't seen signed before. Click More info, then Run anyway. Dragon's binaries aren't code-signed yet; the warning goes away once they are.

macOS: “Apple cannot check it for malicious software”

Clear the quarantine flag once, then run dragon again:

xattr -d com.apple.quarantine "$(command -v dragon)"

Tips & tricks

/tiny, /large, /max

Switch Dragon's lane for a message: Tiny (cheapest), Large (a bigger everyday model), or Max (hardest tasks). Leave it off and you get the default Dragon lane.

/bypass

Auto-approves every tool permission for the rest of the session: shell commands, file edits, network, all of it. No more prompts. Use it when you trust the task.

/auto

Autopilot. Dragon keeps working your last instruction, turn after turn, until it's done or you stop it.

Tab

Toggle Plan mode on/off. Plan has Dragon think through an approach before it touches any files; Build just starts editing.