CLI & Config
| Command | Description |
|---|
goodseed | Start the local viewer (default command) |
goodseed serve [dir] | Start the viewer, optionally from a specific directory |
goodseed serve --port 9000 | Use a custom port (default: 8765) |
goodseed list | List all projects |
goodseed list -p default | List runs in a project |
goodseed upload -p <project> [-r <run_id>] | Upload unuploaded data to the remote API (omit -r to upload all runs) |
| Environment Variable | Default | Description |
|---|
GOODSEED_HOME | ~/.goodseed | Base directory for all data |
GOODSEED_PROJECT | default | Default project name |
GOODSEED_RUN_ID | — | Default run ID (overridden by run_id argument) |
GOODSEED_API_KEY | — | API key for remote sync |
GOODSEED_STORAGE | cloud | Storage mode: disabled, local, or cloud |
Runs are stored as SQLite files at ~/.goodseed/projects/<project>/runs/<run_id>.sqlite. Each run is a single file you can copy, back up, or delete.