Master Seed Code CLI

Installation

Seed Code CLI is distributed through the official installer system. One command per platform — no Python, no package manager.

Windows — PowerShell 5.1+

# Install
PS> irm https://seedcode-cli.vercel.app/install.ps1 | iex

# Verify (open a new terminal first)
PS> seedcode --version
Seed Code CLI 6.2.5

Installs for the current user (no administrator rights), adds seedcode to your user PATH, and verifies the install before finishing. Prefer a GUI? Download SeedCode-CLI-Setup-6.2.5.exe from the GitHub release.

Linux — bash

# Install
$ curl -fsSL https://seedcode-cli.vercel.app/install.sh | bash

# Verify
$ seedcode --version
Seed Code CLI 6.2.5

Installs for the current user. The installer downloads the official release for your platform, verifies its SHA256 checksum, and verifies the installed command before it finishes.

Configuration

Seed Code stores its settings in a single JSON file at ~/.seedcode/config.json (owner-only permissions where the OS supports it). Each provider keeps its own entry, so nothing is shared or overwritten.

# ~/.seedcode/config.json
{
  "active_provider": "default",
  "providers": {
    "default":           { "api_key": "",          "model": "nvidia/nemotron-3-super-120b-a12b:free" },
    "openrouter":        { "api_key": "sk-or-...", "model": "vendor/model" },
    "freemodel_claude":  { "api_key": "fe_oa_...", "model": "claude-sonnet-4-6" },
    "freemodel_codex":   { "api_key": "fe_oa_...", "model": "auto" },
    "aerolink":          { "api_key": "...",       "model": "..." },
    "ollama":            { "api_key": "",          "model": "llama3.2" }
  },
  "ollama_host": "http://localhost:11434",
  "max_tokens": 1024
}

Every provider keeps its own isolated entry — saving or switching one provider never reads or writes another's key slot.

API keys

The built-in Default provider needs no API key. Keys for every other provider are only saved after a real authenticated validation. For CI and containers, environment variables override stored keys: OPENROUTER_API_KEY, FREEMODEL_API_KEY, and AEROLINK_API_KEY. Keys are never printed, logged, or included in an error message.

Providers

Six independent backends — each owns its API key, model, connection status, and history. Switch anytime with /provider; the picker groups choices by what they need.

No model is ever hardcoded — browse any provider's live catalogue with /model. OpenRouter lists 300+ models, 45+ of them free.

Commands

Every command is a slash command, typed inside a seedcode session.

Examples

Code Mode (workspace-aware coding)

you › /codemode on
✓ Code Mode ON
  Workspace: ~/projects/my-app
  Index: 128 indexed, 0 unchanged (incremental)
  The agent now consults .seedcode memory + index before touching files.

Health check

$ seedcode
you › /doctor
✓ Config valid
✓ Network reachable
✓ Provider healthy
3/3 checks passed · environment healthy

Agent Mode (project tools)

you › /agent
✓ Assist Mode ON — the AI can read, edit, search, and run commands

you › /index
▸ src/
  ▸ components/
  ▸ utils/
▸ tests/

Assist Mode (computer control)

you › /assist on
✓ Assist Mode ON
AI · Filesystem · Terminal · Git · Browser · Keyboard
Mouse · Windows · Vision · OCR · Desktop Automation

Troubleshooting

• Command not found — open a new terminal; PATH changes only apply to fresh sessions. The installers verify this before they finish.
• "Setup needed" on the header — the active provider is not usable yet. Run /provider and pick Default (release builds work out of the box) or add a key.
• Auth errors — re-run the API key flow with /apikey, or set OPENROUTER_API_KEY, FREEMODEL_API_KEY, or AEROLINK_API_KEY.
• Rate limits (429) — wait and retry; Seed Code honors the provider's Retry-After hint, or switch provider with /provider.
• Garbled output — use a terminal with truecolor support (Windows Terminal, iTerm2, most modern emulators).

Still stuck? Visit Support or open an issue.