Quickstart

This guide walks you through installing Supercode, authenticating, and running your first prompt. By the end, you'll have a working setup.

1. Install Supercode

Choose your preferred method:

~ $
curl -fsSL https://supercli.vercel.app/install | bash
~ $
npm install -g supercode-cli@latest
~ $
bun install -g supercode-cli
~ $
npx supercode-cli
~ $
brew install supercode

Verify the install:

~ $
supercode --version

2. Log In

Authenticate with GitHub OAuth:

~ $
supercode login

This opens a browser window for authorization. Click Authorize to sign in.

Tip: Chrome may ask for local network access — Supercode runs a temporary local server for the OAuth callback. This is safe. Click Allow.

3. Start Coding

Navigate to a project and run:

~ $
cd /path/to/your-project supercode

The first time you run supercode, it asks whether to trust the files in that folder. Select Yes (skip with supercode --trust).

Supercode then builds a taste profile — learning your preferences as you work.

4. Run Your First Prompt

Type this in the Supercode prompt:

~ $
Create a date.js CLI that outputs the ISO format of the current date. Use commander.js.

Supercode analyzes the request, creates the file, and reports back. Review the changes and type y to accept.

Check what it learned:

~ $
supercode taste

Useful Shortcuts

| Shortcut | Action | | -------- | ------ | | ? | Show all keyboard shortcuts | | Ctrl + T | View taste profile | | /undo | Undo last change | | /redo | Redo undone change | | /connect | Connect an AI provider | | /mode | Switch between Chat, Tools, Agent modes |

Updating

Keep Supercode up to date:

~ $
npm update -g supercode-cli@latest

What's Next