Skip to main content

Troubleshooting & FAQ

Common issues and frequently asked questions for CI-Copilot.

Does it support anything besides GitHub Actions?​

Not yet. GitHub Actions is the only supported platform right now. GitLab CI and Jenkins are on the roadmap.

Which LLMs work?​

OpenAI, Anthropic, Google Gemini, AWS Bedrock, and Azure OpenAI. Set LLM_PROVIDER and LLM_MODEL in your .env file.

Does it work with private repos?​

Yes — your GITHUB_PERSONAL_ACCESS_TOKEN needs repo scope.

What if it can't detect my stack?​

It asks you. The Context Detector has a human-in-the-loop fallback — if detection confidence is low, it prompts for clarification before proceeding.

Will it commit code without asking?​

No. Two approval gates: (1) after plan generation, (2) before commit. Both require your explicit sign-off.

How do I connect a client?​

CI-Copilot speaks the A2A protocol. Any A2A client works. The included docker-compose.yml ships with TalkOps UI at localhost:8080.

Connectivity Issues​

"Connection refused" to CI-Copilot​

Cause: The TalkOps UI or client cannot reach the CI-Copilot server.

Fix:

  • Ensure CI-Copilot is running: docker ps or check the process
  • Set TALKOPS_CI_COPILOT_URL to the correct URL (e.g., http://localhost:10102)
  • If using Docker Compose, ensure both services are on the same network

GitHub API errors​

Cause: Invalid or expired GITHUB_PERSONAL_ACCESS_TOKEN, or insufficient scope.

Fix:

  • Regenerate the token with repo scope
  • Ensure the token has access to the target repository (for private repos)

Workflow Issues​

Plan approval not showing​

Symptom: The agent says it needs approval, but the UI doesn't show buttons.

Fix: Type explicit text approval: "APPROVE", "YES", or "Proceed". The agent's text parser acts as a fallback for UI buttons.

actionlint validation fails repeatedly​

Symptom: The Renderer keeps refining but validation still fails.

Cause: Unusual workflow structure or action combination that actionlint flags.

Fix:

  • Review the generated YAML manually
  • Check actionlint documentation for the specific error
  • Consider simplifying the request or filing an issue with the CI-Copilot team

Debug Logging​

Enable debug logs to see raw tool calls and MCP payloads:

LOG_LEVEL=DEBUG

Output includes tool invocations, MCP payloads, and agent state transitions.