ShipMyAgent
OperationsTroubleshooting

Logs & Debugging

Diagnose runtime issues with logs and state commands

Logs & Debugging

1) Follow runtime logs

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

2) Inspect service state

sma service list
sma extension list

3) Inspect conversation state

sma chat context --chat-key telegram-chat-123
sma chat history --chat-key telegram-chat-123 --limit 50

4) Inspect task artifacts

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

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