Downcity
Configuration

Project Configuration (ship.json)

Most-used project-level fields and practical cautions

Project Configuration (ship.json)

ship.json is the project runtime entrypoint.

{
  "name": "my-agent",
  "model": {
    "primary": "default"
  },
  "start": {
    "host": "127.0.0.1",
    "port": 5314
  },
  "services": {},
  "permissions": {}
}

Cautions

  1. model.primary must resolve in the global model pool.
  2. start.host/start.port affects default CLI routing.
  3. Keep project-level config focused on services; extensions are console-global.

Common commands

city console config get
city console config get model.primary
city console config set start.port 3100

Console Config Storage (ship.db)

Console-global config is now unified in ~/.ship/ship.db with encrypted sensitive fields

Environment Variable Strategy (Console Shared vs Agent Private)

Clear scope and runtime merge logic for global_env, agent_env, channel_accounts, and <agent>/.env

Table of Contents

Project Configuration (ship.json)CautionsCommon commandsRelated docs