// readme

gitcrawl πŸ•·οΈ β€” Pull GitHub down to earth

gitcrawl mirrors GitHub issues and pull requests into local SQLite for maintainers and agents. It provides local search, related-thread clustering, JSON output, and a terminal interface without running a local HTTP service.

Install

Homebrew is the smallest install on macOS and Linux:

brew install openclaw/tap/gitcrawl

Prebuilt archives for macOS, Linux, and Windows are available from GitHub Releases. The installation guide also covers source builds and update checks; source builds require Go 1.27.2 or newer for CrawlKit v0.17.0 and select the patched Go 1.27.3 toolchain automatically. Binaries built with this toolchain require macOS 13 Ventura or newer. A Docker source build keeps its runtime state under one mounted directory.

Sync needs a GitHub token from GITHUB_TOKEN or gh auth token. Generating summaries and embeddings also needs OPENAI_API_KEY; semantic search and clustering use those stored embeddings, while ordinary…