yuhi

local-firstApache-2.0no telemetryworks offline

Claude Code with Yuhi

Yuhi prepares your workspace before AI agents start working — it understands your project locally, builds the right context, and helps Claude Code work more effectively.

Prepare your workspace. Let AI agents work better.

Get started View on GitHub → $ npx @yuhi-ai-labs/yuhi@beta preview
Your repository
files, secrets, data
→
Yuhi
prepared locally
→
Your agent
a clean context

30-second demo

See exactly what the agent will — and won't — receive.

One command previews every file's route. Files marked Prepare locally are transformed on your machine before anything is sent — here, real student records become stable pseudonyms.

yuhi — examples/demo
$
Sent to Claude(9)
  • README.md, src/*.ts, docs/public/guide.md, yuhi.yaml
Prepared locally(3)
  • data/student_scores.csv, config/app.ts, docs/internal/roadmap.md
Kept on your machine(4)
  • customer-data/list.csv, .env, build/app.min.js, package-lock.json
↳ data/student_scores.csv  prepared locally
Original
Tanaka Aoi · S-10241 · 42 · struggles with fractions
pseudonymize → safety check (on your machine)
Claude sees
Subject-B412F3 · Subject-847470 · 42 · struggles with fractions
✓ the original CSV on disk is untouched — only the pseudonymized copy is sent

In your editor

Prepare and launch — inside VS Code.

Run Yuhi from the extension, review the prepared context, then start Claude Code.

Visual Studio Code — my-project
▢
⌕
⑂
▷
Explorer
▸ src
▸ docs
▾ .yuhi / context
document-index.md
summaries /
AGENT_HANDOFF.md
YUHI · Preparation Ready
Workspace
✓ 24 files discovered
✓ 3 documents inspected
✓ Context index created
✓ Agent handoff ready
.yuhi/context/ → document-index.md · summaries/ · AGENT_HANDOFF.md
▷ Start Claude Code

The extension is Available — Beta on the VS Code Marketplace.

Install VS Code Extension View on GitHub or CLI (advanced): npx @yuhi-ai-labs/yuhi@beta

The whole vocabulary

Every file takes one route.

No dashboards to learn. Four routes describe everything Yuhi does — the same words in the CLI, the VS Code extension, and here.

unchanged

Sent to Claude

The original file, sent as-is. Nothing to prepare.

transformed first

Prepared locally

Pseudonymized or secret-masked on your machine, then the safe copy is sent.

process only

Runtime only

Values like .env reach the process at launch — never the context the agent reads.

stays home

Keep local

Customer data and private files never enter the agent's view at all.

Sent to Claude · Prepare locally · Runtime only · Keep local  — that's it.

Context Savings

See the input you didn't send.

After each preparation run, Yuhi estimates the context you avoided sending. The same summary appears in the CLI and the VS Code extension.

Example · estimated
Estimated input before48,320
Estimated input after9,840
Estimated Claude input avoided38,480
Reduction79.6%
42Files excluded
17Files summarized
6Sensitive items kept local
0Original files modified

Actual usage and billing depend on the selected AI product, provider behavior, caching, and pricing.

No fear, no false promises

What Yuhi is — and is not.

Yuhi controls the inputs an agent starts from. We'd rather state the boundary plainly than sell you a guarantee we can't keep.

＃ yuhi is

  • A preview of exactly what an agent will and won't see, before it runs.
  • Deterministic, on-device transforms — pseudonymize, mask secrets — with the original left untouched.
  • One policy (yuhi.yaml) shared by the CLI and the editor.
  • Local-first: no account, no telemetry, works offline.

＃ yuhi is not

  • Workspace boundary: advisory. Initial context prepared by Yuhi; OS sandbox and filesystem enforcement are not enabled. The agent may access files outside the Prepared Workspace if the runtime or user permits it.
  • A guarantee of "zero leakage." A determined process can still reach beyond the prepared copy.
  • A cloud service. Nothing is uploaded to Yuhi — there is no Yuhi server.

≈ 2 minutes

Get started.

Node.js 20+. Yuhi copies into a workspace it owns; your repository is read-only to it.

01
npx yuhi init

Writes yuhi.yaml, honoring your .gitignore.

02
npx yuhi preview

See every file's route before anything runs.

03
npx yuhi run claude

Launch the agent inside the prepared context.

Available now — Beta  ·  npm 0.2.0-beta.2  ·  VS Code 0.2.1  ·  GitHub  ·  Release notes

Open source

Help build the preparation layer before frontier AI.

Yuhi is Apache-2.0 and vendor-neutral. Issues, discussions, and pull requests are welcome.

Contribute on GitHub Browse issues