C
Docs

Session Problems

Troubleshoot issues with coding sessions.

Sessions Not Starting

Agent CLI not installed

C3 requires at least one AI agent CLI (Claude Code, OpenCode, or Codex) to be installed and working. Verify by running the agent's version command in your terminal.

Invalid project path

Ensure the project directory exists and is accessible. Use absolute paths.

Max sessions reached

C3 limits concurrent sessions to 10. Close unused sessions to start new ones.

Stuck Sessions

Session shows "processing" indefinitely

  • Check if the agent is waiting for permission approval
  • Try cancelling the current request
  • Check server logs for errors

Can't send messages

  • Verify connection is active
  • Try switching to another session and back
  • Restart the session if issue persists

Force Restart

If a session is truly stuck, restart the C3 server to clear all sessions. Your conversation history is preserved.

Lost Context

Agent forgot earlier conversation

This happens when the context window fills up and older messages are compacted. Try:

  • Starting a fresh session for new tasks
  • Being more concise in messages
  • Asking the agent to summarize important context

Session not resuming properly

Session files may be corrupted. Try creating a new session instead.