Project Init

The downcity agent init command creates a new Agent project with the minimum files needed to run.

Basic usage

downcity agent init my-project

This creates:

my-project/
├── downcity.json
├── PROFILE.md
├── SOUL.md
├── .downcity/
└── .env

Generated files

• downcity.json — project configuration. See downcity.json.
• PROFILE.md — the agent's visible role and response style. See Profile.
• SOUL.md — deeper, long-term operating principles. See Profile.
• .downcity/ — runtime data directory (sessions, logs, cache).
• .env — environment variables for the project.

Options

# Initialize with a specific template
downcity agent init my-project --template chatbot

# Skip creating default files
downcity agent init my-project --minimal

# Specify a custom directory
downcity agent init my-project --dir ./projects

After init

1. Edit downcity.json to set your agent ID and model binding.
2. Edit PROFILE.md and SOUL.md to shape behavior.
3. Run downcity agent start to start the agent.

Continue with:

• Project Structure
• downcity.json