OperationsTroubleshooting

Common Issues

Typical installation, startup, and config failures

Common Issues

Command not found (`downcity: command not found`)

npm config get prefix
export PATH=$(npm config get prefix)/bin:$PATH

Or run directly with:

npx downcity --version

Port conflict (5314 already in use)

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

`city task/chat/...` cannot connect

Make sure daemon is running:

city agent start
city service list

LLM configuration mismatch

Check:

city console model list
city console config get model.primary

Ensure:

model.primary points to an existing model id in ~/.ship/ship.db
console-global SQLite providers/models entries are valid

Logging & Audit

Runtime logs, conversation history, and task audit artifacts under .ship

Logs & Debugging

Diagnose runtime issues with logs and state commands

Table of Contents

Common Issues Command not found (downcity: command not found)Port conflict (5314 already in use)city task/chat/... cannot connect LLM configuration mismatch