# 🚜 git-steer Documentation
Welcome to the git-steer docs. This guide will help you set up, configure, and use git-steer to manage your GitHub repositories through natural language.
## What is git-steer?
git-steer is a **self-hosting GitHub autonomy engine** that gives you full control over your repos, branches, security alerts, and GitHub Actions through natural language via the Model Context Protocol (MCP).
**Your computer is just the steering wheel.** The engine lives on GitHub:
- Zero local footprint (only Keychain credentials)
- Code pulls from GitHub at runtime
- State stored in a private `git-steer-state` repo
- You control exactly which repos git-steer can access
## Documentation
| Guide | Description |
|-------|-------------|
| [Getting Started](getting-started.md) | Fork, star, prerequisites, and installation |
| [GitHub App Setup](github-app-setup.md) | Create and configure your companion GitHub App |
| [Configuration](configuration.md) | Policies, managed repos, and schedules |
| [Usage Guide](usage-guide.md) | MCP tools, example prompts, Claude Desktop integration |
| [Troubleshooting](troubleshooting.md) | Common issues, offline mode, rate limits |
| [Security](security.md) | Token scopes, audit logs, Keychain, best practices |
## Quick Links
- **Repository**: [github.com/ry-ops/git-steer](https://github.com/ry-ops/git-steer)
- **Issues**: [Report bugs or request features](https://github.com/ry-ops/git-steer/issues)
- **Author**: [ry-ops](https://github.com/ry-ops) • [Blog](https://ry-ops.dev)
## License
MIT - see [LICENSE](https://github.com/ry-ops/git-steer/blob/main/LICENSE)
---
**New here?** Start with the [Getting Started](getting-started.md) guide.
