Getting Started

1. Install

npm install -g downcity
city --version
downcity --version

downcity and city are the same CLI binary.

If city is not found after install, see Common Issues.

To upgrade later, run city update.

city init

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

city 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 downcity.json example:

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

Start the agent (default: background daemon):

city agent start

If you run this outside an initialized agent directory, Downcity can let you pick from registered agents interactively.

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

city agent start --foreground

city agent list
city agent status
city agent list --running

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 port.

city start

If you use the repo's chrome-extension:

Select text on the page, then click the message button near the selection to open the inline input near the selected area.
Clicking the browser extension action icon opens the Extension Popup; press Cmd/Ctrl + U to open the Inline Composer on the page.
The Extension Popup stays minimal: one input box, one send button, page-level send history, and a settings button.
Agent switching in the Extension Popup is intentionally minimal; Channel Chat is auto-resolved from the current Agent's first available conversation.
Click a history item to refill a previous ask from the current page.
Press Cmd/Ctrl + Enter or click the send button to submit (Enter for newline).
Press Esc to close the input box.
If nothing is selected, sending automatically falls back to full-page mode.
Full-page mode prefers the strongest main/article content region; if the page has multiple strong content roots, it merges them and includes page image references.