downcity

install

npm install -g downcity
city -v
downcity -v

city 与 downcity 指向同一个 CLI。

upgrade:

city update

quick start

1. initialize console

city init
city start

2. initialize agent project

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

3. configure model

Create project .env:

LLM_API_KEY=your_key

Minimal downcity.json:

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

4. start agent

city agent start

Debug in foreground:

city agent start --foreground

verify

city agent status
city agents
city service list

troubleshooting

city: command not found

Check npm global prefix and PATH:

npm config get prefix
echo $PATH

If the prefix bin is not in PATH, add it:

export PATH="$(npm config get prefix)/bin:$PATH"

Then reload shell:

rehash
city -v

sudo city: command not found

sudo may use a different PATH from your user shell.

Prefer running city directly. If you really need sudo, use:

sudo env "PATH=$(npm config get prefix)/bin:$PATH" city -v

downcity works but city does not

Reinstall the global package or relink it:

npm install -g downcity

For local source development:

cd /path/to/downcity/packages/downcity
npm install
npm run build
npm link
rehash
city -v

api

GET http://localhost:<agent-port>/health
GET http://localhost:<agent-port>/api/status

POST http://localhost:<agent-port>/api/execute
Content-Type: application/json

{"instructions":"Say hi"}

Use city agent status or city agents to inspect the actual agent port.

debug

By default the runtime logs every LLM request payload (messages + system) to help debugging.

• Disable: set llm.logMessages=false in downcity.json