studio 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

studio agent create [path]

Arguments

• path (optional): project path. Defaults to current directory.
• The interactive default Agent id is derived from the directory name and normalized to snake_case (default only; you can edit it).
• The interactive flow now asks for a model from the console-global model pool and writes it into downcity.json.execution.modelId.
• Created projects now keep execution binding in downcity.json.execution instead of splitting config across model.primary and session.agent.

Options

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

Example

# Initialize in current directory
studio agent create .

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

Example Output (Based on Current Implementation)

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

$ studio agent create .
studio v1.0.0
🚀 Initializing Downcity project: <projectRoot>
✅ Created PROFILE.md
✅ Created SOUL.md
✅ Created downcity.json
✅ Created .downcity/ directory structure
✅ Created downcity.schema.json

Common follow-up commands:

studio model list
studio model get provider openai_main