AETHMERE-OS · LOCAL CONTEXT FOR YOUR AI

Aethmere-OSHelp your AIpick up where work left off.

Organize the project background you want AI to retain in the desktop app, or connect it to Codex and Claude Code through MCP. Explain less, retrieve important context only when needed, and keep project files local. Cloud governance receives only the minimum conversation text in configured environments.

Connect Codex / Claude Code Download the Windows desktop app ↓

Agent Client: Windows / macOS / Linux · Agent Studio: Windows x64

Local project context03

GoalConstraintsDecisions

MCP connected

Read the relevant context, then continue the current task.

PROJECT_GOALKEY_DECISIONOPEN_QUESTION

Project files stay localCodex · Claude Code

WHAT YOU GET

Project context for the AI tools you already use.

Keep using your preferred AI client. Aethmere connects only the background you explicitly save, in a visible and controllable way.

Stop repeating the background

Keep goals, constraints, and key decisions in the project. The next time you open your AI tool, it can continue the same work.

Continuous context

Find important context precisely

Every context item has a stable ID. Agents can list entries first and then read by ID, so the whole project does not need to enter one conversation.

Read on demand

Keep project files on your machine

Agent Client is offline. Studio stores conversations and preferences locally; only configured cloud-governance environments send the minimum conversation text needed for governance—never project paths, files, Git data, shell data, or tokens.

Verifiable boundary

START HERE · 5 MINUTES

Choose the job first, then install the matching component.

For 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.

Recommended · Existing AI toolsAGENT CLIENT · NODE 20+

Connect the current project to Codex or Claude Code

This is the setup path most users need. Open PowerShell, Windows Terminal, or a macOS/Linux terminal and complete these four steps in order.

01
Check that Node.js is ready
```
node --version
npm --version
```
Node.js 20 or later is required. For a new installation, use the current LTS release. Open the Node.js website ↗
02
Install Agent Client from the official site
```
npm install --global https://aethmere.com/downloads/aethmere-agent-0.10.0.tgz
aethmere-agent --version
```
Seeing “Aethmere Agent Client 0.10.0” confirms a successful installation.

Save the first context item in your project

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 list

Replace the first line with the real project path. Content is written only to this project's .aethmere/context.json.

04
Preview first, then write the MCP configuration
```
aethmere-agent doctor
aethmere-agent connect --client all --check
aethmere-agent connect --client all
```
If you use only one client, replace all with codex or claude. After the final command, restart that client; existing configuration is backed up first.

Standalone desktop chat · WindowsWINDOWS X64

Use the Agent Studio desktop app

Use Agent Client for Codex / Claude Code integration. Agent Studio is for local Ollama conversations; Ollama must be running with at least one model available. Local chat still works when Aethmere cloud governance is not configured. Download Ollama for Windows ↗

01
Prepare Ollama and a local modelConfirm that Ollama is running and that at least one model has already been downloaded.
02
Download and fully extract the ZIPDo not run it from inside the archive.
03
Open Aethmere Agent Studio.exeThis is currently an unsigned portable preview, so Windows may show an “Unknown publisher” warning.
04
Choose a local model; a project is optionalConversations, model selection, and project selection remain local. The app does not scan projects automatically.

Download the Windows desktop app

Optional tool · Not part of everyday setup

Install this only to verify the public evaluation

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 trial

Having trouble? Open the common fixes

node 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? Agent Client makes no network requests and has no telemetry. Context stays in .aethmere/context.json inside the current project.

Want to uninstall? Run npm uninstall --global aethmere-agent aethmere-cli. Uninstalling does not remove context files from your projects.

SEALED V5 · SAME QUESTIONS

Same 7B model, same questions: what changed when Aethmere was enabled?

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.

SAME 7B · AETHMERE ENABLED · V5Same 7B model

4,800 / 4,800

100.0% correct · 0 missing

+58.7percentage points

SAME 7B · NO MEMORYSame model · Direct answers

1,982 / 4,800

41.3% correct · 2,818 failed

V5 results by language
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

Earlier V3 sealed set2,400 / 2,4000 missing

No-memory 7B failures2,818 / 2,818answered correctly with Aethmere enabled in V5

Items the no-memory 7B originally answered correctly0 regressionsAethmere enabled · Combined Chinese and English V5

Download public summary ↓Method and limitations ↗

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.

18-DIMENSION NATIVE SCORECARD · V13 · 2026-08-26

V5 measured score recalculated: Aethmere is 10.00 / 10 with 18 stable passes.

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.

Aethmere0.7.0 · 2c1df71

10.00 / 10Rank 1 / 5 · 18 / 18 stable PASS

Letta Code0.30.29

7.22 / 10Rank 2 / 5 · 13 / 18 stable PASS

MemOS2.0.30

7.22 / 10Rank 2 / 5 · 13 / 18 stable PASS

Mem02.0.18

6.67 / 10Rank 4 / 5 · 12 / 18 stable PASS

Graphiti0.29.3

0.56 / 10Rank 5 / 5 · 1 / 18 stable PASS

Stable results across 18 dimensions · PASS requires both runs to pass with matching semantics
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

Stable PASS / applicable dimensions (N/A excluded from the applicable denominator)
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

The 10.00 score applies only to Aethmere's 18 / 18 stable two-run passes under this locked V5 contract. Graphiti's 14 stable FAIL outcomes record native operations that did not finish within the locked limit and make no finding about whether those functions exist. A different operator ran this owner-run evaluation on an independent physical Apple Silicon Mac. Its scope excludes third-party certification, open-world leaderboards, and production SLAs.

PUBLIC DOWNLOADS

The four downloads serve different jobs; you do not need all of them.

For Codex or Claude Code, install Agent Client only. Agent Studio is the standalone desktop chat app. The VS Code extension is optional, and the evaluation CLI only verifies public data. Every file is available directly from the official site with a public SHA-256 checksum.

RecommendedNODE · TGZ

Agent Client

Save project context locally and connect it to Codex or Claude Code through MCP. This is the only component required for everyday integration; it makes no network requests and has no telemetry.

npm install -g https://aethmere.com/downloads/aethmere-agent-0.10.0.tgz

Download TGZ package ↓GitHub Release ↗

aethmere-agent-0.10.0.tgz · 6.9 KB

Standalone desktop chatWINDOWS X64 · ZIP

Agent Studio

Portable Windows desktop app that requires Ollama to be installed and running locally. Use Agent Client for Codex / Claude Code integration. Studio does not scan projects automatically and has no telemetry.

Fully extract the ZIP, then run Aethmere Agent Studio.exe

Download for Windows ↓Verify SHA-256 ↗

aethmere-agent-studio-0.11.0-win32-x64.zip · 143.2 MB · unsigned preview

OptionalVS CODE · VSIX

VS Code extension

Optional helper: save selected editor text to local context, inspect entries, and copy the MCP connection command for the current project. After downloading, choose “Install from VSIX” in the VS Code Extensions view.

Extensions → … → Install from VSIX

Download extension ↓GitHub Release ↗

aethmere-vscode-0.10.0.vsix · 13.0 KB

Evaluation dataNODE · TGZ

Evaluation CLI

Only 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.tgz

Download evaluation CLI ↓GitHub Release ↗

aethmere-cli-0.10.2.tgz · 5.9 KB

GOOD FIT

Built for work that takes more than one conversation.

If one conversation solves the problem, you do not need another layer. Long-running work that advances over many sessions is where saved context becomes useful.

Long-term research

Save research goals, decision evidence, and questions that still need confirmation.

Complex projects

Carry requirements, constraints, and key decisions across multiple sessions.

High-stakes decisions

Use stable IDs to point to context you can actually inspect and reduce unsupported completion.

YOUR CONTEXT, YOUR BOUNDARY

What stays local, and when does a component use the network?

The network boundary depends on the component: Agent Client is fully local; Agent Studio uses local Ollama by default and sends minimum conversation text only when cloud governance is configured.

01Agent Client is offline and has no telemetry; project context stays in .aethmere/context.json inside the current project

02Studio keeps conversations, model selection, and project selection local. Configured governance sends only minimum conversation text—never project paths, files, Git data, shell data, or tokens

03Every release file includes a version, size, and SHA-256 checksum

ABOUT AETHMERE-OS

Aethmere-OS is developed and operated by 青岛果冻先生网络科技有限责任公司.

We build Aethmere-OS (Shízhòu) around durable project context, verifiable memory, and clear local-data boundaries for long-running AI work. This official site provides product information, public downloads, evaluation methods, and a security-reporting path.

START LOCALLY

Start with one real project and let Codex or Claude Code read the context you chose to save.

View the 5-minute setup