OperationsTroubleshooting

Common Issues

Typical installation, startup, and config failures

Common Issues

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

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

Or run directly with:

npx shipmyagent --version

Port conflict (3000 already in use)

lsof -nP -iTCP:3000 -sTCP:LISTEN
sma agent on --port 3100

`sma task/chat/...` cannot connect

Make sure daemon is running:

sma agent on
sma service list

LLM configuration mismatch

Check:

sma console config get llm
sma 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