localfirst 0.3.0

Your hardware runs first. Cloud is the exception, not the rule.

LocalFirst

Your hardware runs first. Cloud is the exception, not the rule.

LocalFirst sits between you and Claude Code. It shows exactly what gets uploaded to Anthropic, blocks secrets before they leave your machine, and runs file operations locally — zero cloud tokens.

Install

pip install localfirst

localfirst claude

The problem

Claude Code uploads your code to Anthropic on every request. You cannot see what goes up. Your .env files get included even with .claudeignore. A simple session burns $0.07+ before you type anything.

What LocalFirst does

1. Inspector — see every request live, tokens, files, costs

2. Secret Gate — block .env and API keys before they reach Anthropic

3. Local MCP Tools — grep, find, read, tree, git run locally — 0 cloud tokens

Typical savings: 30-60% of all tokens.

Setup

pip install localfirst

localfirst mcp config

Usage

localfirst claude                       # Claude with LocalFirst active

localfirst claude --mode block_secrets  # block secrets automatically

localfirst inspect                      # inspector only

localfirst stats                        # token savings

localfirst check                        # check tools

---

Built on LAO