Docs — seed

Install

Download seed.sh into a directory you trust. Read it, then run it. Do not pipe curl to sh.

Run

First argument is a channel name or an OpenAI-compatible API URL. Second is the key. Model is optional.

Channel

deepseek is built in. Other names are looked up in the seed pack catalog.

API URL

Any OpenAI-compatible /v1 endpoint works. The script normalizes it to /v1/chat/completions.

Later runs

First run writes ~/.seed/.env. After that, the same file runs from any project directory. Empty line or Ctrl-D exits. Type /ini at the prompt to install a global seed command.

Load a pack

A pack is a JSON prompt bundle. Browse published packs, then download one next to seed.sh.

Open the pack catalog

Published install lines live on each pack page. Host your own catalog with SEED_PACK_ROOT.

Write your own pack

A pack is a directory. index.json lists required and optional files. Every other file is a prompt — the model invents the implementation on the machine.

index.json

{
  "version": "1",
  "required": {
    "init": "init.json"
  },
  "optional": {
    "seed_agent": "seed-agent.json",
    "web_ide": "web-ide.json"
  }
}

version is a string. required and optional map a short name to a file in the same directory. Other JSON files in the pack are prompts those entries fetch when they run.

Change behavior by editing the JSON. Do not add code to seed.sh.

Quick start