Developer guide

Start where your code and agent already live.

GitGecko keeps local execution, self-hosting, and cloud preview separate so the authentication and data boundary stay clear.

Run locally MCP and API status

Quick start

npx gitgecko review

Your selected agent or provider retains its own authentication. Local review does not require a GitGecko cloud account.

Run locally

Run a review in any repository. GitGecko detects a configured Claude, Codex, or OpenCode pathway before using a provider key.

npx gitgecko review

Bring your own model

Use a local OpenAI-compatible endpoint such as LM Studio, Ollama, or vLLM. You own the model endpoint and credentials.

gitgecko review --pathway local

Self-host

Start the self-hosted services when your team needs a controlled review and index environment.

docker compose up

Capability status

available

Local review

CLI review through a detected local agent or configured provider.

available

Deterministic checks

ast-grep and regex analysis establish reproducible findings before model review.

available

MCP gateway

Self-hosted Streamable HTTP MCP is available on its loopback gateway. Public host-routed MCP requires an authenticated ingress and is not shipped by Compose.

preview

Cloud execution

Hosted execution is private preview. Access and entitlements are not yet a public self-serve contract.

planned

Public REST API

No public REST API is published. Do not integrate against an undocumented cloud endpoint.