surgite

Standup summaries from Git history, in a browser or terminal.

Quickstart

Workplace deployment requires Docker Compose 2.24.0 or newer and HTTPS:

git clone https://github.com/nicoleman0/surgite.git
cd surgite
cp .env.example .env
# In .env, set AUTH_MODE=multi_user and BOOTSTRAP_OWNER_EMAIL=you@work.example.
# Configure an HTTPS reverse proxy before exposing the app.
docker compose up -d
./scripts/bootstrap-admin.sh

Log in, open /admin, and create an email-pinned user invitation for each colleague. Surgite does not email invitation links. Copy each link and share it privately with its intended recipient.

Local CLI — no server or database:

pip install surgite
surgite /path/to/repo --since 7.days.ago

Add --summarize for an AI summary after configuring a provider key.

Personal web app — clone the repository and start Compose:

git clone https://github.com/nicoleman0/surgite.git
cd surgite
cp .env.example .env
docker compose up -d

Authentication remains off by default. The full deployment and conversion procedures are in docs/self-host.md.

Features

• Per-user repositories, prompt settings, summaries, and shared links
• Local CLI or a self-hosted FastAPI/Postgres/SvelteKit application
• Anthropic, Groq, DeepSeek, or OpenAI-compatible local models
• Email/password auth, API keys, encrypted per-user provider keys, Git connections, and audit logs

Private repositories

Add an HTTPS Git connection in Settings with a credential-free origin, username, and read-only access token. Surgite encrypts it at rest and only supplies it to Git through a non-interactive askpass helper. Never paste credentials into a repository URL.

Documentation

• Self-hosting
• Security model and security policy
• API stability policy and OpenAPI contract
• Contributing, release history, and upgrade guides

Development

uv sync --group dev
docker compose up -d db
uv run alembic upgrade head
uv run pytest
cd frontend && npm install && npm run check && npm run test

See CONTRIBUTING.md for the full workflow and AGENTS.md for architecture and project conventions.

License

MIT © 2026 Nick Coleman