Common Issues

Command not found (studio: command not found / studio: command not found)

npm config get prefix
echo $PATH
export PATH=$(npm config get prefix)/bin:$PATH
rehash
studio --version

Or run directly with:

studio --version

Notes:

• studio and city come from the same downcity package but expose different command surfaces.
• New installs should not require manual chmod +x.
• If sudo studio ... fails but studio ... works, it is usually a sudo PATH issue rather than an install failure.

Port conflict (5314 already in use)

lsof -nP -iTCP:5314 -sTCP:LISTEN
studio agent doctor . --fix
studio agent restart .

studio task/chat/... cannot connect

Make sure daemon is running:

studio agent start
studio plugin list

LLM configuration mismatch

Check:

studio model list
studio config get model.primary

Ensure:

1. model.primary points to an existing model id in ~/.downcity/downcity.db
2. console-global SQLite providers/models entries are valid
3. For Kimi (Moonshot), use provider.type as moonshot-cn or moonshot-ai
4. moonshot-cn defaults to https://api.moonshot.cn/v1
5. moonshot-ai defaults to https://api.moonshot.ai/v1
6. Use a model name that matches the target endpoint, such as kimi-k2-0905-preview or kimi-k2.5