{"id":47596119,"url":"https://github.com/hackastak/repog","last_synced_at":"2026-04-19T16:05:44.155Z","repository":{"id":342703998,"uuid":"1167674404","full_name":"hackastak/repog","owner":"hackastak","description":"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.","archived":false,"fork":false,"pushed_at":"2026-04-06T06:09:52.000Z","size":45913,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-06T06:28:39.309Z","etag":null,"topics":["ai","cli-tool","code-search","devtools","embeddings","github-api","go","golang","knowledge-base","llm","rag","semantic-search","sqlite","vector-database","vector-search"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hackastak.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-02-26T15:00:06.000Z","updated_at":"2026-04-06T06:09:55.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hackastak/repog","commit_stats":null,"previous_names":["hackastak/repog"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/hackastak/repog","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackastak%2Frepog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackastak%2Frepog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackastak%2Frepog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackastak%2Frepog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hackastak","download_url":"https://codeload.github.com/hackastak/repog/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackastak%2Frepog/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32012805,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","cli-tool","code-search","devtools","embeddings","github-api","go","golang","knowledge-base","llm","rag","semantic-search","sqlite","vector-database","vector-search"],"created_at":"2026-04-01T18:05:28.636Z","updated_at":"2026-04-19T16:05:44.139Z","avatar_url":"https://github.com/hackastak.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RepoG\n\nAI-powered knowledge base for your GitHub repositories.\n\n[![CI](https://github.com/hackastak/RepoG/actions/workflows/ci.yml/badge.svg)](https://github.com/hackastak/RepoG/actions/workflows/ci.yml)\n[![Go Report Card](https://goreportcard.com/badge/github.com/hackastak/repog)](https://goreportcard.com/report/github.com/hackastak/repog)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## What is RepoG?\n\nRepoG is a CLI tool that syncs your GitHub repositories to a local knowledge base, generates vector embeddings, and enables semantic search, Q\u0026A, and AI-powered recommendations across your entire codebase.\n\n**Key Features:**\n- Sync owned and starred repositories to a local SQLite database\n- Generate vector embeddings using Google Gemini\n- Semantic search across all your code using natural language\n- Ask questions and get AI-synthesized answers (RAG)\n- Get repository recommendations for specific tasks\n- Summarize repositories with AI\n\n## Installation\n\n### Homebrew (macOS)\n\n```bash\nbrew install hackastak/tap/repog\n```\n\n### Download Binary\n\nDownload the latest release for your platform from the [Releases page](https://github.com/hackastak/repog/releases). See the [Changelog](CHANGELOG.md) for version history.\n\n### From Source\n\nRequires Go 1.22+ and a C compiler (GCC or Clang) for CGO.\n\n```bash\ngo install github.com/hackastak/repog/cmd/repog@latest\n```\n\n## Quick Start\n\n### 1. Get Your API Keys\n\nYou'll need two API keys:\n\n**GitHub Personal Access Token (PAT)**\n1. Go to [GitHub Settings \u003e Developer settings \u003e Personal access tokens \u003e Fine-grained tokens](https://github.com/settings/tokens?type=beta)\n2. Create a new token with:\n   - **Repository access**: All repositories (or select specific ones)\n   - **Permissions**: `Contents: Read-only`, `Metadata: Read-only`\n\n**Google Gemini API Key**\n1. Go to [Google AI Studio](https://aistudio.google.com/apikey)\n2. Create a new API key\n\n### 2. Initialize RepoG\n\n```bash\nrepog init\n```\n\nThis will prompt you for your API keys and store them securely in your system keychain.\n\n### 3. Sync Your Repositories\n\n```bash\nrepog sync --owned --starred\n```\n\n### 4. Generate Embeddings\n\n```bash\nrepog embed\n```\n\n### 5. Start Searching\n\n```bash\nrepog search \"authentication middleware\"\nrepog ask \"Which repos use PostgreSQL?\"\nrepog recommend \"building a CLI tool\"\n```\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `repog init` | Configure API keys and initialize the database |\n| `repog sync` | Sync repository metadata and content |\n| `repog embed` | Generate vector embeddings for synced repos |\n| `repog search \u003cquery\u003e` | Semantic search across your codebase |\n| `repog ask \u003cquestion\u003e` | Ask questions with AI-synthesized answers |\n| `repog recommend \u003ctask\u003e` | Get repository recommendations |\n| `repog summarize \u003crepo\u003e` | AI summary of a specific repository |\n| `repog status` | View knowledge base statistics |\n\n### Sync Options\n\n```bash\nrepog sync --owned           # Sync only your own repositories\nrepog sync --starred         # Sync only starred repositories\nrepog sync --owned --starred # Sync both (default)\n```\n\n## Data \u0026 Privacy\n\n- **Local First**: All data is stored locally in `~/.repog/repog.db`\n- **Secure Credentials**: API keys are stored in your system keychain (macOS Keychain, Windows Credential Manager, or Linux Secret Service)\n- **Privacy**: Code is only sent to:\n  - **GitHub API**: To fetch repository metadata and content\n  - **Google Gemini API**: To generate embeddings and AI responses\n\n## GitHub API Rate Limits\n\nRepoG respects GitHub's rate limit of 5,000 requests per hour for authenticated users. Use `repog status` to check your remaining quota.\n\n## Roadmap\n\nRepoG is under active development. Here's what's coming next:\n\n- **Enhanced embeddings** - Support for multiple embedding providers (OpenAI, local models)\n- **Performance** - Incremental syncing and re-ranking\n- **TUI** - Improve usability by building RepoG terminal user interface using Bubbletea \n- **Export capabilities** - Generate documentation and knowledge graphs from your repos\n- **Code analysis** - Dependency graphs, language statistics, and complexity metrics\n- **Multi-platform Git support** - GitLab, Bitbucket, and self-hosted Git servers\n\nSee the [issues page](https://github.com/hackastak/repog/issues) for planned features and discussions.\n\n## Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details on:\n\n- Development setup and prerequisites\n- Running tests and linting\n- Code style and conventions\n- Submitting pull requests\n\n### Quick Links\n\n- [Report a Bug](https://github.com/hackastak/repog/issues/new?template=bug_report.md)\n- [Request a Feature](https://github.com/hackastak/repog/issues/new?template=feature_request.md)\n- [Good First Issues](https://github.com/hackastak/repog/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)\n\n## Documentation\n\n| Document | Description |\n|----------|-------------|\n| [CONTRIBUTING.md](CONTRIBUTING.md) | Guide for contributors |\n| [CHANGELOG.md](CHANGELOG.md) | Version history and release notes |\n| [LICENSE](LICENSE) | MIT License |\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n---\n\nBuilt with [sqlite-vec](https://github.com/asg017/sqlite-vec) and [Google Gemini](https://ai.google.dev/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhackastak%2Frepog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhackastak%2Frepog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhackastak%2Frepog/lists"}