Skip to main content

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

Metadata

Release files for localfirst 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for localfirst 0.3.0
File Size Uploaded
localfirst-0.3.0.tar.gz 17.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for localfirst 0.3.0
File Interpreter ABI Platform
localfirst-0.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 38.2 kB

Release files / localfirst-0.3.0.tar.gz

Download URL localfirst-0.3.0.tar.gz
Size 17.2 kB
Tags Source
SHA-256 checksum
How to use checksums
e1ce5c80798ec5f58015da89a35cb54bc29d3bef7234fb940f5b429b0b4f3d7f
BLAKE2b-256 checksum
How to use checksums
09ae239497c9ad384c02060868dcfea45b7ae75c755c25c94ec864f156cad9f4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.1

Release files / localfirst-0.3.0-py3-none-any.whl

Download URL localfirst-0.3.0-py3-none-any.whl
Size 21.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
78368407185b7a1861e904adadde31bb67fc60c3b866233079b1f9f95c6fe479
BLAKE2b-256 checksum
How to use checksums
c71df28300621b1df45563683857c67415e2a7ce1b28f070214a8dc3a2e15816
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.1
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page