https://github.com/hackastak/repog
RepoG is a CLI-first, local AI-powered tool that helps you explore, search, and understand your GitHub repositories using semantic search and LLM-powered insights.
https://github.com/hackastak/repog
ai cli-tool code-search devtools embeddings github-api go golang knowledge-base llm rag semantic-search sqlite vector-database vector-search
Last synced: 30 days ago
JSON representation
RepoG is a CLI-first, local AI-powered tool that helps you explore, search, and understand your GitHub repositories using semantic search and LLM-powered insights.
- Host: GitHub
- URL: https://github.com/hackastak/repog
- Owner: hackastak
- License: mit
- Created: 2026-02-26T15:00:06.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-06T06:09:52.000Z (about 1 month ago)
- Last Synced: 2026-04-06T06:28:39.309Z (about 1 month ago)
- Topics: ai, cli-tool, code-search, devtools, embeddings, github-api, go, golang, knowledge-base, llm, rag, semantic-search, sqlite, vector-database, vector-search
- Language: Go
- Homepage:
- Size: 43.8 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# RepoG
AI-powered knowledge base for your GitHub repositories.
[](https://github.com/hackastak/RepoG/actions/workflows/ci.yml)
[](https://goreportcard.com/report/github.com/hackastak/repog)
[](https://opensource.org/licenses/MIT)
## What is RepoG?
RepoG is a CLI tool that syncs your GitHub repositories to a local knowledge base, generates vector embeddings, and enables semantic search, Q&A, and AI-powered recommendations across your entire codebase.
**Key Features:**
- Sync owned and starred repositories to a local SQLite database
- Generate vector embeddings using Google Gemini
- Semantic search across all your code using natural language
- Ask questions and get AI-synthesized answers (RAG)
- Get repository recommendations for specific tasks
- Summarize repositories with AI
## Installation
### Homebrew (macOS)
```bash
brew install hackastak/tap/repog
```
### Download Binary
Download the latest release for your platform from the [Releases page](https://github.com/hackastak/repog/releases). See the [Changelog](CHANGELOG.md) for version history.
### From Source
Requires Go 1.22+ and a C compiler (GCC or Clang) for CGO.
```bash
go install github.com/hackastak/repog/cmd/repog@latest
```
## Quick Start
### 1. Get Your API Keys
You'll need two API keys:
**GitHub Personal Access Token (PAT)**
1. Go to [GitHub Settings > Developer settings > Personal access tokens > Fine-grained tokens](https://github.com/settings/tokens?type=beta)
2. Create a new token with:
- **Repository access**: All repositories (or select specific ones)
- **Permissions**: `Contents: Read-only`, `Metadata: Read-only`
**Google Gemini API Key**
1. Go to [Google AI Studio](https://aistudio.google.com/apikey)
2. Create a new API key
### 2. Initialize RepoG
```bash
repog init
```
This will prompt you for your API keys and store them securely in your system keychain.
### 3. Sync Your Repositories
```bash
repog sync --owned --starred
```
### 4. Generate Embeddings
```bash
repog embed
```
### 5. Start Searching
```bash
repog search "authentication middleware"
repog ask "Which repos use PostgreSQL?"
repog recommend "building a CLI tool"
```
## Commands
| Command | Description |
|---------|-------------|
| `repog init` | Configure API keys and initialize the database |
| `repog sync` | Sync repository metadata and content |
| `repog embed` | Generate vector embeddings for synced repos |
| `repog search ` | Semantic search across your codebase |
| `repog ask ` | Ask questions with AI-synthesized answers |
| `repog recommend ` | Get repository recommendations |
| `repog summarize ` | AI summary of a specific repository |
| `repog status` | View knowledge base statistics |
### Sync Options
```bash
repog sync --owned # Sync only your own repositories
repog sync --starred # Sync only starred repositories
repog sync --owned --starred # Sync both (default)
```
## Data & Privacy
- **Local First**: All data is stored locally in `~/.repog/repog.db`
- **Secure Credentials**: API keys are stored in your system keychain (macOS Keychain, Windows Credential Manager, or Linux Secret Service)
- **Privacy**: Code is only sent to:
- **GitHub API**: To fetch repository metadata and content
- **Google Gemini API**: To generate embeddings and AI responses
## GitHub API Rate Limits
RepoG respects GitHub's rate limit of 5,000 requests per hour for authenticated users. Use `repog status` to check your remaining quota.
## Roadmap
RepoG is under active development. Here's what's coming next:
- **Enhanced embeddings** - Support for multiple embedding providers (OpenAI, local models)
- **Performance** - Incremental syncing and re-ranking
- **TUI** - Improve usability by building RepoG terminal user interface using Bubbletea
- **Export capabilities** - Generate documentation and knowledge graphs from your repos
- **Code analysis** - Dependency graphs, language statistics, and complexity metrics
- **Multi-platform Git support** - GitLab, Bitbucket, and self-hosted Git servers
See the [issues page](https://github.com/hackastak/repog/issues) for planned features and discussions.
## Contributing
We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details on:
- Development setup and prerequisites
- Running tests and linting
- Code style and conventions
- Submitting pull requests
### Quick Links
- [Report a Bug](https://github.com/hackastak/repog/issues/new?template=bug_report.md)
- [Request a Feature](https://github.com/hackastak/repog/issues/new?template=feature_request.md)
- [Good First Issues](https://github.com/hackastak/repog/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)
## Documentation
| Document | Description |
|----------|-------------|
| [CONTRIBUTING.md](CONTRIBUTING.md) | Guide for contributors |
| [CHANGELOG.md](CHANGELOG.md) | Version history and release notes |
| [LICENSE](LICENSE) | MIT License |
## License
MIT License - see [LICENSE](LICENSE) for details.
---
Built with [sqlite-vec](https://github.com/asg017/sqlite-vec) and [Google Gemini](https://ai.google.dev/).