Common Errors
Solutions for frequently encountered errors in C3.
Server Errors
"Port already in use"
Another process is using the port. Either:
- Stop the other process
- Use a different port:
ccc --mqtt-port 9000
"Agent CLI not found"
Install your AI agent CLI (Claude Code, OpenCode, or Codex) and ensure it's in your PATH.
"Permission denied"
Run the server with appropriate permissions or check file system access to the project directory.
App Errors
"Connection refused"
- Server may not be running
- Check host and port settings
- Verify network connectivity
"Authentication failed"
- Double-check username and password
- Ensure SSL setting matches server configuration
"Session not found"
The session may have been cleaned up. Start a new session.
Agent Errors
"Rate limited"
Too many requests sent too quickly. Wait a moment and try again.
"Context too long"
The conversation exceeded context limits. Start a new session or let the agent auto-compact.
"Tool execution failed"
Check the tool output for specific error messages. Common causes:
- File not found
- Permission denied
- Invalid arguments
- Command not installed
Debug Mode
Run the server with --debug for more detailed error messages.