Personal Model: local-first AI memory for coding agents

_{Auto-playing preview · Full-quality demo and v0.3.2 release notes}

Build your HUMAN.md — one evidence-linked Personal Model for Claude Code, Codex, Cursor Agent, and other trusted MCP clients.

Personal Model is an open-source, local-first long-term memory Runtime. It learns how you think and work from focused activity captured on your Mac after you grant macOS permission, then gives your AI tools inspectable context to continue work and make grounded decisions.

Runs locally on your Mac. Private by default. Yours to inspect, correct, export, and delete.

Install Personal Model · Connect your AI tool · Star Personal Model on GitHub

Concept illustration of a mature Personal Model.

Why Personal Model

Personal Model turns focused activity from the apps you use into a portable context layer, keeps it on your Mac, and makes it available to the trusted AI clients you choose.

• One memory across agents. Connect the same Personal Model to Claude Code, Codex, Cursor Agent, and other MCP-compatible clients.
• Evidence, not hidden summaries. Important claims retain source receipts; new evidence can strengthen, revise, or overturn an earlier inference.
• User-owned by design. Inspect, correct, export, or delete your model and data without depending on a hosted memory service.
• More than chat history. Personal Model learns from focused activity after you explicitly grant macOS permissions.

Your Personal Model is your HUMAN.md

Personal Model connects activity into progressively deeper context:

The result is a living model of what matters now, how you tend to decide, and where your attention is moving.

Works with Claude Code, Codex, Cursor Agent, and MCP clients

The MCP client guide covers prerequisites, verification, the permission boundary, transport details, HTTP fallback, and troubleshooting.

Personal Model is an MCP server used by trusted MCP clients. Other MCP servers—such as Filesystem, GitHub, Slack, or Google Drive—are separate tools and are not Personal Model integrations unless that path is explicitly built and tested.

Use cases

These visuals show agent workflows enabled by Personal Model. The Runtime supplies evidence-linked local context through MCP; connected agents own task selection and execution, and external actions still require your authority.

1. One Root — A Model of You

Thousands of moments. One evolving model of you.

Personal Model turns sourced observations into relationships, patterns, higher-order structure, and one current Root: what matters now, how you tend to decide, and where your attention is moving.

From Points to Lines, Faces, Volumes, and one Root—a living model of who you are and what matters now.

2. Same AI. Different You.

The model is the same. The person it understands is different.

Two people can give the same AI the same prompt and deserve different answers. Your Personal Model changes how an agent prioritizes, decides, writes, and acts—because it understands who it is working for.

The same prompt should not produce the same answer for everyone. Give AI a model of you.

3. One MCP — Turn coding agents into proactive agents

Your coding agent finds its own work

Connect Personal Model once through MCP. Codex, Claude Code, and other trusted agents can use the same model of your goals, priorities, working patterns, and boundaries.

A connected agent can search Personal Model for unfinished work, rank proposed next steps against your priorities, and separate local implementation from external actions that need your approval.

Continue where you left off

Work while you sleep

Install, connect, and verify

Install Personal Model, connect a trusted MCP client, then verify the local Runtime.

1. Install with your data

Requirements: macOS 13 or newer and Xcode Command Line Tools. For the shortest package-managed installation:

uv tool install personal-model
persome onboard
persome model open --after 30

The distribution is named personal-model; the installed CLI is persome.

For the most explicit source-based first run:

git clone https://github.com/Intuition-Lab/personal-model.git
cd personal-model
bash install.sh

After successful interactive onboarding, the source installer opens the unified local setup experience immediately.

What onboarding proves

• persome onboard explains each macOS request before it appears.
• Accessibility is granted to the versioned mac-ax-helper and, only when event-driven capture is enabled, mac-ax-watcher.
• Screen Recording is requested only when the effective screenshot or local-OCR policy requires pixels. Personal Model never requires Full Disk Access.
• On Apple Silicon, local OCR uses bundled PP-OCRv6; on Intel, it uses the macOS Apple Vision framework. Onboarding verifies the isolated worker on both architectures.
• Unified localhost onboarding offers a read-only, multi-source import and builds the first model from existing Markdown history. Local folders are always available; Obsidian and Notion appear only when detected on the Mac. The same sources remain available through persome import-data; see the import guide.
• It proves the final lifecycle owner and Runtime generation, then reports a fresh-capture receipt in standard daemon mode or an explicit readiness/privacy receipt for supported alternate modes such as trusted ingest.

An LLM is optional for collection and BM25 recall, but required for semantic modeling. You can configure a hosted/local provider for unattended processing:

persome llm setup
persome llm status --check