Error Codes

Error Codes

Common error codes and solutions.

---

System Errors

Code	Message	Cause	Solution
ENOENT	File not found	File doesn't exist	Check file path
EACCES	Permission denied	Insufficient permissions	Fix file permissions (chmod)
EADDRINUSE	Address in use	Port already bound	Change port or kill process
ECONNREFUSED	Connection refused	Service not running	Start the service

Database Errors

Code	Message	Cause	Solution
SQLITE_BUSY	Database locked	Concurrent access	Close other connections, increase timeout
SQLITE_NOTFOUND	No such table	Schema not initialized	Run init command
SQLITE_CONSTRAINT	Constraint violation	Duplicate key	Use different key or update existing

HTTP Errors

Code	Message	Cause	Solution
401	Unauthorized	Invalid API key	Check API key
429	Rate limit exceeded	Too many requests	Reduce request rate, upgrade tier
500	Internal server error	Server error	Check logs, retry
503	Service unavailable	Service down	Wait and retry

MCP Errors

Code	Message	Cause	Solution
-32600	Invalid request	Malformed JSON-RPC	Check request format
-32601	Method not found	Unknown tool	Use valid tool name
-32602	Invalid params	Wrong parameters	Check parameter schema
-32603	Internal error	Server error	Check logs

Configuration Errors

Error: providers.default is required

Solution: Add "default": "anthropic" to providers config

Error: ANTHROPIC_API_KEY environment variable not set

Solution: export ANTHROPIC_API_KEY="sk-..."

Error: Invalid agent type: unknown-type

Solution: Use valid agent type (see agent types command)

---

Related:

• Troubleshooting