Carry context across sessions
Save project goals, constraints, and decisions. List and read entries by stable ID, with context content stored locally.
A permission can change while the work continues. Aethmere connects continuity with governance: the public client gates operations with live acknowledgement, while GPM research tests when revoked facts must stop being released.
Starting with project context for Claude Code and Codex
A · ACTIVEA · REVOKEDRELEASE?DENYALLOWGPM research replay · Structured tool output from Claude Code / Codex
After the source revokes fact A, a new session requests it again. The research adapter denies A and still releases valid fact B. Follow the request, state change, and refusal reason in the recording.
This is the GPM research implementation. Public Agent Client 0.12.1 governs client operations; the revoked-state release check uses a separate research adapter.
The technical argument, inspectable recorded results, and a standard mapping with explicit coverage limits.
Keep the AI client you already use and connect through Agent Client. The public release provides these capabilities.
Save project goals, constraints, and decisions. List and read entries by stable ID, with context content stored locally.
Formal client operations verify the account, policy, and version, then require a durable start acknowledgement. Failed acknowledgement stops execution.
Governance events record steps, outcomes, and reasons without context content. An undelivered terminal event blocks the next formal operation.
Agent Client connects Codex and Claude Code. Agent Studio is a standalone chat app, the VS Code extension is an editor helper, and the evaluation CLI verifies historical data.
Formal operations require an Aethmere account and a live governance connection. Accounts are currently invitation-only; existing account holders can connect using the steps below.
Save project context locally and connect it to Codex or Claude Code through MCP. Formal operations require an Aethmere account and live governance acknowledgement.
npm install -g https://aethmere.com/downloads/aethmere-agent-client-0.12.1.tgzaethmere-agent-client-0.12.1.tgz · 31.9 KBPortable Windows desktop app requiring local Ollama. Chat and context operations require live governance acknowledgement; project content stays local.
Fully extract the ZIP, then run Aethmere Agent Studio.exeaethmere-studio-0.12.0-windows-x64.zip · 143.1 MB · unsigned previewSave and read context through Agent Client 0.12.1 and connect supported AI clients. Operations stop on an outdated client, missing login, or failed governance connection.
Extensions → … → Install from VSIXaethmere-vscode-0.12.0.vsix · 22.9 KBOnly for verifying the historical V3/V5 aggregate, running public evidence-ID examples, and checking release hashes across the website and GitHub. It does not connect Codex or Claude Code.
npm install -g https://aethmere.com/downloads/aethmere-cli-0.10.2.tgzaethmere-cli-0.10.2.tgz · 5.9 KBFor everyday use with Codex or Claude Code, install Agent Client. For a standalone Windows chat app backed by local Ollama models, use Agent Studio. The evaluation CLI only verifies public data and is not part of everyday setup.
Open PowerShell, Windows Terminal, or a macOS/Linux terminal and complete these five steps in order.
node --version
npm --versionNode.js 20 or later is required. For a new installation, use the current LTS release. Open the Node.js website ↗npm install --global https://aethmere.com/downloads/aethmere-agent-client-0.12.1.tgz
aethmere-agent --versionSeeing “Aethmere Agent Client 0.12.1” confirms installation; formal operations also require an account connection.aethmere-agent login --code <one-time-code>
aethmere-agent doctorExisting account holders can sign in at app.aethmere.com and generate a one-time computer connection code. Formal operations do not run without live acknowledgement.cd "path/to/your-project"
aethmere-agent init
aethmere-agent add --id PROJECT_GOAL --title "Project goal" --text "Give the AI the goals and constraints needed to continue this project"
aethmere-agent listReplace the first line with the real project path. Content is written only to this project's .aethmere/context.json.aethmere-agent connect --client all --check
aethmere-agent connect --client allIf you use only one client, replace all with codex or claude. After the final command, restart that client; existing configuration is backed up first.Agent Studio uses local Ollama models and requires an Aethmere account plus a live governance connection. Chat and context operations stop when the connection is unavailable. Download Ollama for Windows ↗
aethmere is a separate verification tool. It displays the historical V3/V5 aggregate, runs public evidence-ID examples, and verifies release files on the website and GitHub. Skip this section if you only want to use Aethmere.
npm install --global https://aethmere.com/downloads/aethmere-cli-0.10.2.tgz
aethmere --version
aethmere doctor --online
aethmere eval
aethmere trialnode or npm is not found: Install Node.js 20 or later, then close and reopen the terminal.
aethmere-agent is not found: Reopen the terminal first. If Windows PowerShell blocks scripts, run aethmere-agent.cmd --version or use Command Prompt.
connect reports not-installed: The matching client configuration was not detected. Install and open that client once, or replace --client all with the client you actually use: codex or claude.
Concerned that the command uploads your project? Context content stays in .aethmere/context.json inside the project. The client sends closed behavior events to Aethmere without project files, prompts, responses, or context content.
Want to uninstall? Run npm uninstall --global aethmere-agent aethmere-cli. Uninstalling does not remove context files from your projects.
Public clients connect to the first-party governance service with a closed event schema. Project context content stays in the current project.
Sealed results from August 2026, retained with their original scope for technical review.
Both groups use the same 7B model, sealed questions, languages, and denominator. One group has Aethmere enabled; the baseline uses no memory and answers directly. This is a historical sealed evaluation from August 2026. Deterministic answers score each fixed item, while failures, timeouts, missing outputs, and required-but-absent answers remain in the denominator.
100.0% correct · 0 missing
41.3% correct · 2,818 failed
| Test set | Same 7B · Aethmere enabled | Same 7B · No memory | Pass-rate gap |
|---|---|---|---|
| Chinese · 2,400 questions | 2,400 / 2,400100.0% | 1,346 / 2,40056.1% | +43.9percentage points |
| English · 2,400 questions | 2,400 / 2,400100.0% | 636 / 2,40026.5% | +73.5percentage points |
| Combined · 4,800 questions | 4,800 / 4,800100.0% | 1,982 / 4,80041.3% | +58.7percentage points |
These are historical sealed results for bounded tasks. They do not represent the current production version, this public client, open-world question answering, or accuracy on arbitrary questions. Public files contain only aggregate results and integrity hashes—not private items, prompts, or raw model outputs.
Five locked versions each ran twice under one 18-dimension contract, for 180 checked cells. The composite uses only stable two-run PASS evidence: 10 × stable PASS ÷ 18. FAIL, FLAKY, and N/A earn no points. The former subjective documentation baselines and weights have been withdrawn.
| Dimension | Aethmere | Letta Code | MemOS | Mem0 | Graphiti |
|---|---|---|---|---|---|
| D01Native write, durable identity, exact read | PASS | PASS | PASS | PASS | PASS |
| D02Addressed retrieval and scope isolation | PASS | PASS | PASS | PASS | FAIL |
| D03Ranked relevance retrieval | PASS | FAIL | FAIL | PASS | FAIL |
| D04Update and current value | PASS | PASS | PASS | PASS | FAIL |
| D05Lifecycle transition and removal | PASS | PASS | PASS | PASS | FAIL |
| D06Logical scope isolation | PASS | PASS | FAIL | PASS | FAIL |
| D07Data-root isolation | PASS | PASS | PASS | FAIL | FAIL |
| D08Metadata filtering | PASS | N/A | FAIL | PASS | FAIL |
| D09Temporal boundary | PASS | PASS | PASS | PASS | FAIL |
| D10Revision history | PASS | PASS | FAIL | PASS | FAIL |
| D11Relationship resolution | PASS | FAIL | FAIL | FAIL | FAIL |
| D12Source trace | PASS | PASS | PASS | PASS | FAIL |
| D13Batch persistence and exactly-once | PASS | FAIL | PASS | PASS | FAIL |
| D14Restart recovery | PASS | PASS | PASS | FAIL | FLAKY |
| D15Official export | PASS | PASS | PASS | N/A | N/A |
| D16Official import | PASS | PASS | PASS | N/A | N/A |
| D17Concurrency, idempotency, integrity | PASS | FAIL | PASS | FLAKY | FAIL |
| D18Invalid-input containment and recovery | PASS | PASS | PASS | PASS | FAIL |
| Product | Locked version | Stable PASS | FAIL | FLAKY | N/A |
|---|---|---|---|---|---|
| Aethmere | 0.7.0 · 2c1df71 | 18 / 18 | 0 | 0 | 0 |
| Letta Code | 0.30.29 | 13 / 17 | 4 | 0 | 1 |
| MemOS | 2.0.30 | 13 / 18 | 5 | 0 | 0 |
| Mem0 | 2.0.18 | 12 / 16 | 3 | 1 | 2 |
| Graphiti | 0.29.3 | 1 / 16 | 14 | 1 | 2 |
Aethmere-OS (Shízhòu) develops state governance and continuity for long-running AI agents, starting with project context. This site provides the public client, research demonstrations, a paper, and technical feedback paths. About us →