👻 RepoSeance: Talk to the Ghosts of Your Codebase

Description and use

RepoSeance is a local-first AI tool that lets developers explore codebase history, ask questions, and receive evidence-backed answers without uploading code to external services.

Problem

Developers lose historical context when working on unfamiliar or inherited codebases, making it hard to understand implementation decisions and repository evolution.

Outcome

RepoSeance enables developers to quickly uncover the hidden history of a codebase, answer questions with source‑backed evidence, and maintain privacy by keeping all analysis local.

Workflow

• Install RepoSeance via npm or npx
• Navigate to a repository and run reposeance init
• Index the repository with reposeance index
• Ask a question using reposeance ask "..." or start an interactive chat with reposeance chat
• Explore commit history with reposeance history <path>

Evidence

RepoSeance combines source-code analysis, Git history investigation, and Retrieval-Augmented Generation (RAG) to let developers ask questions about their repositories and receive AI-generated answers supported by source-code and Git evidence.

Source

RepoSeance is an open-source, local-first AI codebase archaeologist that helps developers understand unfamiliar repositories, investigate forgotten implementation decisions, and reconstruct the history behind software projects.

Source

I wanted RepoSeance to be genuinely local-first. By using Ollama for inference and Gemma as an open-weight model family, developers can run AI-powered repository investigations without depending on a hosted AI API.

Source