local-brain 0.3.3

Chat with local Ollama models that can explore your codebase

Local Brain

Chat with local Ollama models that can explore your codebase.

local-brain "What files changed recently?"
local-brain "Review the code in src/"
local-brain "Generate a commit message"
local-brain "Explain how auth works"

Install

uv pip install local-brain

Or with pipx:

pipx install local-brain

Requires: Ollama with a model:

ollama pull qwen3

Usage

local-brain "prompt"              # Ask anything
local-brain -v "prompt"           # Verbose (show tool calls)
local-brain -m llama3.2 "prompt"  # Different model

The model has tools to explore your codebase — it reads files, checks git, lists directories on its own.

Examples

# Explore
local-brain "What's in this repo?"
local-brain "How does the auth system work?"

# Review
local-brain "Review the git changes"
local-brain "Review src/main.py for issues"

# Git
local-brain "Generate a commit message for staged changes"
local-brain "Summarize recent commits"

# Explain
local-brain "Explain how agent.py works"

Tools

The model can use (all read-only for security):

Tool	What it does
read_file	Read file contents
list_directory	List files (glob patterns)
file_info	Get file metadata
git_diff	See code changes
git_status	Check repo status
run_command	Run safe shell commands

Development

git clone https://github.com/IsmaelMartinez/local-brain.git
cd local-brain
uv sync
uv run local-brain "Hello!"

License

MIT