Downcity
CommandsAgent

city agent create

Create/initialize a Downcity agent project

city agent create

Create/initialize a Downcity agent project in the target path.

Usage

city agent create [path]

Arguments

  • path (optional): project path. Defaults to current directory.
  • The interactive default Agent name is derived from the directory name and replaces _/- with spaces (default only; you can edit it).

Options

  • -f, --force [enabled]: allow overwriting existing ship.json (dangerous)

Example

# Initialize in current directory
city agent create .

# Initialize in another directory
city agent create ./my-agent-project

Example Output (Based on Current Implementation)

The examples below are aligned with current command implementations in package/src (including default output mode and field structure). Placeholder values are used for environment-specific fields.

$ city agent create .
city version: 1.0.0
πŸš€ Initializing Downcity project: <projectRoot>
βœ… Created PROFILE.md
βœ… Created SOUL.md
βœ… Created USER.md
βœ… Created ship.json
βœ… Created .ship/ directory structure
βœ… Created ship.schema.json
$ city agent create .
city version: 1.0.0
❌ Console model pool is empty.
   Please configure at least one model before `city agent create`:
   1) city console model create
   2) or use city console model update/test for scripting