Downcity
OperationsTroubleshooting

Logs & Debugging

Diagnose runtime issues with logs and state commands

Logs & Debugging

1) Follow runtime logs

tail -f .downcity/logs/$(date +%F).jsonl

2) Inspect plugin state

studio plugin list

3) Inspect conversation state

studio chat context --chat-key ctx_xxxxxxxxxxxxxxxx
studio chat history --chat-key ctx_xxxxxxxxxxxxxxxx --limit 50

4) Inspect task artifacts

ls -la .downcity/task/<taskId>
ls -la .downcity/task/<taskId>/<timestamp>

run.json and result.md usually reveal the root cause quickly.

Common Issues

Typical installation, startup, and config failures

Performance Issues

Reduce response latency and long task execution time

Table of Contents

Logs & Debugging1) Follow runtime logs2) Inspect plugin state3) Inspect conversation state4) Inspect task artifacts