Project Init

city agent create creates Workspace runtime and Skills directories, then stores the Agent as a global entity. It does not generate an Agent declaration file in the Workspace.

city agent create

Without a path, the interactive flow lets you use the current directory or open the operating system's native folder picker. Pass a relative or absolute path to skip that choice:

city agent create .
city agent create ./my-project
city agent create /absolute/path/to/my-project

Generated structure:

my-project/
├── .env
├── .agents/
│   └── skills/
└── .downcity/

The global database stores the Agent ID, model binding, startup options, and Plugin config. Project .env overrides Global Env from ~/.downcity/.env; explicit process environment variables have the highest priority.

# Allow replacing existing Agent config in the global database
city agent create ./my-project --force

After initialization, add project Skills under .agents/skills, inspect the generated agent_id with city agent list, then run city agent start <agent_id>.

Continue with:

• Project Structure