Master Seed Code CLI

Everything from your first install to advanced configuration — in one place.

New here? Launch the CLI Simulator first.

Launch Simulator

Installation

pip (all platforms)

Requires Python 3.9 or newer. Installs straight from PyPI.

# Install and launch
$ pip install seedcode-cli
$ seedcode

# Verify
$ seedcode --version
seedcode v1.0.0

uv (isolated tool)

$ uv tool install seedcode-cli

Windows installer

A standalone setup wizard — no Python required. Download SeedCodeSetup.exe.

Linux & macOS ZIP

Grab the packaged ZIP from MEGA — it includes the complete package for both platforms.

Tip: whichever method you choose, seedcode doctor confirms everything is in place.

Configuration

Seed Code stores its settings in a single TOML file at ~/.seedcode/config.toml. Run seedcode config for the guided wizard, or edit the file directly.

# ~/.seedcode/config.toml
[provider]
name = "openrouter"
model = "glm-5.2"
stream = true

[appearance]
theme = "midnight"        # midnight | paper | ember | terminal-classic
markdown = true

API keys

Keys are stored securely by the config wizard. For CI and containers, the SEEDCODE_API_KEY environment variable takes precedence over the config file.

Providers

ProviderBest forConfig value
OpenRouterHundreds of models, including free tiersopenrouter
ZenMuxUnified routing with automatic failoverzenmux
AeroLinkLow-latency, regional endpointsaerolink
OllamaFully local, private, no API keyollama

Browse availability any time with seedcode models — 312+ models on OpenRouter, 47+ of them free.

Commands

CommandDescription
seedcodeLaunch the interactive assistant in your current directory
seedcode chatStart a focused chat session with your configured model
seedcode configOpen the configuration wizard for providers, keys, and themes
seedcode doctorDiagnose your setup — keys, connectivity, and environment
seedcode modelsBrowse and search every model available on your provider
seedcode updateUpdate Seed Code CLI to the latest release in place

Examples

One-shot prompts

$ seedcode "write a haiku about git"
branches drift apart
a merge brings them home again
conflicts, then release

Health check

$ seedcode doctor
✓ Python 3.12 detected
✓ API key configured
✓ Network reachable (82 ms)
6/6 checks passed · environment healthy

Troubleshooting

  • Command not found — make sure your Python scripts directory is on PATH, or reinstall with uv tool install seedcode-cli.
  • Auth errors — re-run seedcode config or check SEEDCODE_API_KEY.
  • Garbled output — use a terminal with truecolor support (Windows Terminal, iTerm2, most modern emulators).

Still stuck? Visit Support or open an issue.

🖥 Live CLI