Local Yep

A local-first agent framework for your Claude Code — works with your own Claude (Pro/Max or API key); we sell the framework and tools, never Claude.

Local Yep turns your Claude Code into Yep — a personal agent with durable memory and an identity that's yours. It runs on your own Claude and never touches your Claude credentials. Memory lives in a local SQLite database under ~/.local-yep/; nothing in the core paths phones home.

Why Local Yep

• 🧠 Durable memory that's yours. Facts, episodes, and reflections persist in local SQLite (FTS5). Yep recalls before it reasons and reflects after it acts — so it gets to know you across sessions, not just within one.
• 🔒 Local-first, private by default. Your memory never leaves your machine and the core paths open no network socket. Your Claude auth stays yours.
• 🎭 An identity, not a chatbot. A frozen ethical spine (honesty, memory-is-precious, privacy, calibrated uncertainty) plus a personalizable voice — name, owner, preset, and tone dials — set in a quick first-run wizard.
• 🧩 A local tool & pack ecosystem. Discover, install, and run tools and packs from a toolspace, with per-tool credentials kept in your OS keyring.
• ⚡ Drop-in for Claude Code. Wires in as an MCP server + hooks. Run gent in any folder, or yepgent init a specific project — and yepgent uninstall cleanly reverses it.

Install

Requires Python 3.10+ and your own Claude Code (https://claude.com/claude-code).

pipx install local-yep      # `pipx install yepgent` resolves to the same package

Testers — the bootstrap script also checks your prerequisites, wires the hooks, and can apply an activation token:

# macOS / Linux
curl -fsSL https://yepgent.com/dl/install.sh -o install.sh && bash install.sh --gated

# Windows (PowerShell)
iwr https://yepgent.com/dl/install.ps1 -OutFile install.ps1; ./install.ps1 -Gated

With no --wheel / -Wheel it fetches the current wheel from yepgent.com/dl/; pass --wheel ./local_yep-*.whl if you were handed the file directly.

Then open a new terminal and run gent. On install you'll accept the alpha Terms (type I AGREE, or pass --accept-terms for an unattended install).

Developers:

pip install -e .
yepgent --help

Quickstart

gent                       # launch Claude Code as Yep in the current folder
gent "help me ship X"      # …with a first prompt
gent /path/to/project      # …in another folder
yepgent onboard            # set Yep's name / owner / voice anytime

Your first gent offers a quick setup (name / owner / voice) — skippable, and one-time.

Commands

How it works

• Memory — ~/.local-yep/memory.db (SQLite + FTS5). Recall is lexical (BM25) by default; opt in to semantic recall with the embeddings extra.
• Identity — a read-only ethical spine plus a configurable overlay, rendered into every session by the SessionStart hook.
• Wiring — a slim memory MCP server + four Claude Code hooks (SessionStart / UserPromptSubmit / Stop, plus a PreToolUse guard that protects the spine, identity, and hook wiring from unconfirmed edits). gent runs that wiring globally via a portable profile; yepgent init writes it into a project. Either way, your project's own servers (e.g. C3) keep working alongside it.

Optional: semantic recall

pip install 'local-yep[embeddings]'   # or: pipx inject local-yep fastembed
yepgent memory reindex                # backfill vectors for existing rows

Adds meaning-based recall (a 768-dim local model, ~140 MB one-time download, fully offline thereafter) alongside the lexical path. The default stays BM25 — no model download, nothing fetched.

Privacy & the one rule

Memory is 100% local. We never sell, store, proxy, or resell Claude — you bring your own Claude auth and it stays yours. The binding guardrails live in docs/auth-guardrails.md in the repository.

Docs

• Downloads & install — current wheel, both bootstrap scripts
• Alpha Terms — terms & acknowledgment

In the repository (private alpha): docs/install.md (install & uninstall), docs/alpha-guide.md (gated alpha, operator + tester), docs/user-guide.html (full end-user guide), docs/positioning.md, docs/pricing.md, docs/auth-guardrails.md, and PLAN.md (the living build plan).

Status

Private alpha — works with your own Claude Code on Windows / macOS / Linux.

_{Local Yep — your agent, your memory, your machine.}