Introduction
What is Keystone and why it exists
What is Keystone?
Keystone is an architect's second brain. It connects to your GitHub repositories, ingests every commit, pull request, and code change, and synthesizes the decisions, trade-offs, and rationale behind your codebase.
Instead of digging through git logs or asking teammates "why was this built this way?", you ask Keystone.
Why Keystone?
Every engineering team accumulates implicit knowledge: decisions made in PRs, trade-offs discussed in reviews, patterns established over time. This knowledge lives in people's heads and scattered across git history. When someone leaves, or when a new engineer joins, that context is lost.
Keystone captures and organizes this knowledge automatically:
- Continuous ingestion: every push to your repository is analyzed and indexed
- Decision extraction: Keystone identifies architectural decisions, trade-offs, and design patterns
- Semantic search: ask questions in natural language and get answers grounded in your actual codebase history
- Always up to date: as your code evolves, so does Keystone's understanding
How it works
- Connect your GitHub repository via the GitHub App
- Ingest: Keystone processes your commit history and begins watching for new changes
- Ask: use the agent chat to query your codebase's history, decisions, and rationale
Next steps
- Install Keystone and connect your first repository
- Quick start guide to get up and running in minutes