city agent start

Start the process for a target agent.

This page remains as a command entry point. For the fuller explanation, see Start and Stop an Agent and CLI / start.

Usage

city agent start [path] [options]

Key options

• -h, --host <host>: service host (default 0.0.0.0)
• --foreground [enabled]: run in foreground

Behavior

• Checks console process before start.
• If path is provided, that directory is used directly.
• If path is omitted and current directory is already an initialized agent project, current directory is used.
• If path is omitted and current directory is not an agent project, the CLI opens an interactive selector from registered agents.
• Agent port is always auto-assigned by console.
• Project downcity.json.start.host/port is not required for daemon startup.
• With --foreground, runs in current terminal; otherwise runs in background mode.
• --foreground is a temporary terminal session; once terminal exits, the process exits too.

Related commands

• city agent restart
• city agent list
• city agent status
• city start

Example Output

$ city agent start .
downcity v1.0.437

Agent daemon started                            lucas_whitman
  project   /Users/you/Documents/bots/lucas_whitman

$ city agent start .
downcity v1.0.437

❌ console is not running. Please run `city start` first.