Install

Woopcode requires Bun 1.0 or later. It is built on Bun's runtime, not merely packaged with it, so Node will not do.

bun --version

If that prints nothing, install Bun first — one command, no root:

curl -fsSL https://bun.sh/install | bash

Install Woopcode#

bunx woopcode

bun add -g woopcode

bunx fetches and runs it without installing, which is the right way to try it. A global install puts woopcode on your path for everyday use.

Check it#

woopcode --version

What it needs#


Runtime	Bun 1.0+
Platforms	macOS, Linux — on Windows, use WSL
Network	Outbound HTTPS to the provider
Account	A Google Gemini API key — free to create

When it does not work#

bun: command not found — Bun is not installed or not on your path. Install it, then open a new terminal so your shell picks up the change.

woopcode: command not found after a global install — Bun's global bin directory is not on your PATH. bun pm bin -g prints it; add that to your shell profile.

Permission errors during install — do not reach for sudo. Bun installs into your home directory, and a global install run as root leaves files your user cannot update later.

Next#

Connect a provider — the API key
Your first session — one change, end to end

Added in woopcode@0.6.0