Getting Started

This guide covers the detailed setup for the Supercode Terminal CLI.

Prerequisites

  • Node.js 18+ or Bun 1.x — Runtime for the CLI
  • Git — Required for repository operations
  • GitHub Account — For authentication
  • AI Provider API Key — For the AI model (optional if using server-configured models)

Installation

~ $
curl -fsSL https://supercode.ai/install | bash

The install script detects your platform, downloads the appropriate binary, and adds it to your PATH.

npm / Bun

~ $
npm install -g supercode-cli@latest
~ $
bun install -g supercode-cli@latest

Homebrew

~ $
brew install supercode

NPX (No Install)

~ $
npx supercode-cli

Windows (WSL)

Windows support is via WSL. Install WSL first, then use any of the methods above:

~ $
# Inside WSL (Ubuntu/Debian) npm install -g supercode-cli@latest

Post-Install Verification

~ $
supercode --version

If this fails, ensure the install path is in your $PATH:

~ $
# npm global prefix export PATH="$(npm root -g)/../bin:$PATH"

First Run

1. Authenticate

~ $
supercode login

2. Navigate to a Project

~ $
cd ~/projects/my-app

3. Start Supercode

~ $
supercode

On first run in a project, Supercode asks:

  1. Trust prompt — "Do you trust the files in this folder?" Select Yes.
  2. Taste profile — Supercode scans for package manager, language, and structure.

4. Initialize

Run /init to let Supercode deeply analyze your project:

~ $
/init

This indexes your codebase for context-aware assistance.

Configuration

AI Provider

Configure your AI provider with /connect:

~ $
/connect

This walks you through selecting a provider and entering an API key.

Command-Line Options

~ $
supercode --trust # Skip trust prompt supercode --skip-taste # Skip taste profiling supercode --no-init # Skip project initialization

What's Next