github-twin

MCP

by ChristopherDavenport · v0.0.17

Personal RAG over your GitHub history (commits, code, reviews), served to Claude Code over MCP.

mcplocal

MCP configuration

stdio

Command

uvx serve github-twin==0.0.17

Environment

  • GITHUB_TOKENsecret

    GitHub personal access token. Optional: github-twin can also pick the token up from `gh auth token` or from its own OAuth device-flow login (`gt auth login`).

  • ANTHROPIC_API_KEYsecret

    Optional. Enables the Claude backend for `gt summarize`, `gt distill`, and `gt eval`. Defaults to local Ollama when unset.

  • GEMINI_API_KEYsecret

    Optional. Enables the Gemini backend for embedding and the LLM seam. Vertex AI ADC via `GT_GEMINI_PROJECT` is also supported.

  • GT_PATHS__DATA_DIR

    Optional. Override the on-disk data directory holding the SQLite index, embeddings, and cached GitHub responses. Defaults to `$XDG_DATA_HOME/github-twin`.

Install in one click with Zurek

Browse here, install from the native macOS app — pick targets, fill env vars, and write configs safely.