LocalContext is a desktop app that turns a project folder into a single, LLM-ready context block. Pick the files you need, watch the exact token count against your model's context window, then export to Markdown or XML and copy it straight into ChatGPT, Claude, Gemini, or any local model. No uploads, no telemetry, no cloud — the scan and the build happen entirely on your device.
|
Point at any project root and LocalContext walks it recursively, honouring your |
Selected files are counted with |
Build a single context block as Markdown (per-file fenced blocks with language detection) or
XML ( |
|
A checkbox file tree with a filter box and Select All / Clear controls lets you compose exactly the context you want. Text files are pre-selected; binaries are greyed out and skipped automatically. |
Everything runs on-device — there is no network call, no telemetry, no cloud. The Electron shell uses
|
Built on Electron 33 and plain Node.js, LocalContext runs the same on Windows, macOS and Linux — no build toolchain, native modules, or external services required to get started. |
A simple, one-way pipeline: pick a folder, scan it, count tokens, build the block, copy or save.
┌──────────────┐ ┌───────────────────────┐ ┌────────────────────────┐
│ Pick folder │ ──▶ │ Scan + filter │ ──▶ │ Tokenize │
│ (dir:pick) │ │ .gitignore + defaults │ │ gpt-tokenizer (exact) │
└──────────────┘ │ binary / >1MB skip │ │ chars/4 fallback │
└───────────────────────┘ └────────────────────────┘
│
▼
┌───────────────────────┐ ┌────────────────────────┐
│ Copy / Save │ ◀── │ Build context │
│ clipboard · .md/.xml │ │ Markdown or XML │
└───────────────────────┘ └────────────────────────┘
Logic lives in pure, IO-light modules under src/*; Electron and all filesystem / dialog / clipboard
access stay at the edges (main.js + preload.js).
LocalContext/
├─ main.js # Electron main: window + IPC (pick / scan / build / copy / save), dialogs, clipboard
├─ preload.js # secure contextBridge — exposes a minimal `window.lc` API to the renderer
├─ src/
│ ├─ scanner.js # recursive walk + .gitignore (ignore) + default ignores + binary / size filters
│ ├─ tokenizer.js # gpt-tokenizer (exact) with chars/4 fallback
│ └─ builder.js # assemble Markdown / XML context, per-file language detection, token count
└─ renderer/ # UI — index.html · styles.css · app.js (file tree, budget bar, preview)
Requires Node.js 18+ (ships against Electron 33).
# 1. Clone
git clone https://github.com/DuminAndrew/LocalContext
cd LocalContext
# 2. Install dependencies
npm install
# 3. Launch
npm start # or: npm run dev (opens detached DevTools)- Open folder — pick your project root; LocalContext scans it instantly, honouring
.gitignore. - Select files — tick what you need, or use Select All / Clear and the filter box to narrow down. Binaries and oversized files are skipped for you.
- Watch the budget — the live token estimate and the 128k / 200k / 1M budget bar tell you when you are about to overflow the model's context window.
- Choose a format — Markdown for readable, fenced per-file blocks, or XML for structured
<file>blocks. - Build — get the exact token count plus a preview of the assembled context.
- Copy or Save — drop it straight into your LLM chat, or export to
.md/.txt/.xml.
- Tauri / Rust v2 — migrate the shell to Tauri for a dramatically lighter, faster binary.
- Signature compression — strip bodies and keep declarations/signatures to fit huge repos into a window.
- Custom templates — user-defined output layouts and per-file headers/footers.
- Git URL clone — paste a repository URL and build context without cloning manually first.
- Persisted presets — remember selected files and budget per project.
- Markdown & XML export — fenced per-file Markdown and structured XML blocks.
- Exact token counting —
gpt-tokenizerwith a gracefulchars/4fallback. - .gitignore-aware recursive scan — default ignores, binary detection, 1 MB size cap.
If LocalContext saves you time, you can support its development. Replace the placeholders below with your real, verified addresses and QR images before publishing.
| Coin | Network | Address (placeholder) |
|---|---|---|
| BTC | Bitcoin | bc1qXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| ETH | Ethereum / EVM | 0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| USDT | TRON (TRC20) | TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| BTC | ETH | USDT (TRC20) |
|---|---|---|
 |
 |
 |
- Always verify the address on the official release page of this repository — never from forks, issues, or screenshots.
- Check the network (TRC20 ≠ ERC20): sending on the wrong chain means the funds are lost.
- A donation is voluntary support — it grants no SLA, no priority support, and is not an investment.
- Maintainers will never ask for donations in private messages.
Released under the MIT License — © Andrew Dumin (DuminAndrew).
If LocalContext helped you, consider leaving a star ⭐
