`city agent create`

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

This page remains as a command entry point. For the fuller project initialization guide, see Create Your First Agent and CLI / create.

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).
The interactive flow now lets you choose an execution mode directly: API Model Pool, Local llama (~/.models), Kimi ACP, Claude ACP, or Codex ACP.
Created projects now write unified downcity.json.execution instead of splitting config across model.primary and session.agent.
When you choose Local mode, the selected GGUF file is stored in plugins.lmp.model, and later local-model management goes through city lmp ....

Options

-f, --force [enabled]: allow overwriting existing downcity.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 packages/downcity/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 downcity.json
✅ Created .downcity/ directory structure
✅ Created downcity.schema.json

If you choose ACP or Local mode, initialization can proceed even when the console model pool is empty.

Common follow-up commands for Local mode:

city lmp status
city lmp models
city lmp use <gguf-file>

city agent create