Getting Started

1. Install

npm install -g downcity
downcity --version

downcity and city are the same CLI binary.

city console init

This creates console-global config under ~/.ship/.

city console start

city agent start requires console to be running first.

cd /path/to/your-repo
city agent create .

Initialization generates:

Create .env at project root (do not commit):

LLM_API_KEY=your_key

Minimal ship.json example:

{
  "name": "my-agent",
  "version": "1.0.0",
  "model": {
    "primary": "default"
  }
}

Start runtime (default: background daemon):

city agent start

Use foreground mode when you want logs in the current terminal:

city agent start --foreground

city agent status
city console agents

Notes:

Agent ports are auto-allocated by console, so Quickstart should not assume a fixed port.
In multi-agent setups, each agent can have a different runtime port.

city console ui start