Agent and Project Setup

Create an Agent identity and independently register an existing project

Create an Agent identity and register an existing project separately:

city agent create --name Reviewer --id reviewer --model MODEL_ID
city workspace register ./my-project --name Project
city workspace list

Agent configuration lives in ~/.downcity/agents/<agent_id>/agent.json and SOUL.md. Workspace registration lives in downcity.db. Creation does not generate project files, install Skills or bind the Agent to a Workspace. Registration requires an existing accessible directory.

Place project Skills under .agents/skills when needed. Project .env overrides Global Env from ~/.downcity/.env; explicit process environment variables have the highest priority.

Explicitly start a City host before executing:

city on
city agent chat reviewer --new-session --workspace WORKSPACE_ID

Use city agent update reviewer --model MODEL_ID to configure a default model. Updates apply to new Sessions; existing snapshots and overrides are retained. See Resource Management for offline access, deletion boundaries and JSON output.

Continue with: