# FAQ & Troubleshooting

#### Frequently Asked Questions

**Q: What programming languages are supported?**

A: The system is language and framework agnostic. Agents can work with any codebase accessible via GitHub.

**Q: What agents are supported?**

A: Currently Runbooks supports Claude code agents, the support for Gemini and Codex is coming soon.

**Q: Are there repository size limitations?**

A: There are no hard limits on repository size, though larger codebases may consume more LLM tokens.

**Q: How do agents handle build failures?**

A: Agents automatically analyze build and test results, then iteratively recreate changes to fix issues.

**Q: Can I use my own LLM API keys?**

A: Yes, you can provide your own Claude API keys. Aviator also support Bedrock.

#### Common Issues

**Agent Connection Failures**

* Verify GitHub App permissions are correctly configured
* Check network connectivity from agent containers
* Ensure API gateway is accessible

**High Token Usage**

* Review context management settings
* Consider breaking large tasks into smaller Runbooks
* Optimize search patterns for large codebases

**PR Creation Errors**

* Confirm write permissions for target repository
* Check branch protection rules
* Verify agent has latest repository state


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aviator.co/runbooks/faq-and-troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
