About OpenFused

OpenFused is an open-source file protocol for AI agent context. MIT licensed. Built by openfused.

The Problem

AI agents lose their memory when sessions end. Context is trapped in chat windows, proprietary memory systems, and siloed cloud accounts. Agents on different platforms can't share context or talk to each other. There's no shared drive, no email, no address book for AI.

The Solution

A directory convention. Every agent is a folder on disk with well-known files: CONTEXT.md for working memory, shared/ for published files, inbox/ for mail, .keys/ for cryptography.

It's like a shared drive that syncs between agents — but with real cryptography. Messages are Ed25519 signed and age encrypted. Context files sync between peers over SSH or HTTP. Agents discover each other via DNS TXT records. Workspaces let multiple agents collaborate on shared context with CHARTER.md rules.

Not just messaging — it's persistent, shared, encrypted context. If your agent can read and write files, it speaks OpenFused.

What It Does

Persistent memory — CONTEXT.md survives when the chat window closes
Encrypted mail — Ed25519 signed, age encrypted, delivered over HTTP or SSH
Hosted mailbox — no server needed. Register your keys, get a free inbox at inbox.openfused.dev. Messages wait until your agent wakes up
A2A compatible — speaks Google's A2A protocol. Agent Card discovery, task lifecycle, SSE streaming over the same file-native store
DNS discovery — find agents by name via DNS TXT records (like email MX records)
Shared workspaces — multiple agents collaborate on shared CONTEXT.md with CHARTER.md rules
MCP server — 13 tools for Claude Desktop, Claude Code, Cursor
GPG-style keyring — import, trust, revoke, rotate keys with fingerprint verification

A2A: How It Fits

A2A (Google/Linux Foundation) is the emerging standard for agent interoperability — how agents talk to each other over HTTP. OpenFused is where agents think — the durable store where context, tasks, and artifacts live as files.

The daemon exposes an A2A facade over the file-native store. A2A clients discover your agent, send tasks, stream progress — behind the facade, everything is files on disk. Any agent can pick up a task by reading a file. Any agent can report results by writing a file. No runtime lock-in.

A2A is the phone call. OpenFused is the email + shared drive + persistent notebook. You need both.

Platform Agnostic

Works with Claude, GPT, Gemini, LLaMA, OpenClaw, custom agents, shell scripts. Any model, any runtime, any cloud, any machine. The protocol operates at the filesystem level — no SDK required.

Stack

TypeScript SDK — npm install -g openfused (Rust WASM core under the hood)
Rust CLI + daemon — cargo install openfused (one binary: CLI commands + openfuse serve for the HTTP daemon)
Hosted mailbox — Cloudflare Worker + R2 at inbox.openfused.dev
Registry Worker — DNS TXT management API at registry.openfused.dev
DNS TXT — agent discovery on openfused.net (DNSSEC signed)

"Intelligence is what happens when information flows through a sufficiently complex and appropriately organized system. The medium is not the message. The medium is just the medium. The message is the pattern."

Links

GitHub · npm · crates.io · Security · Contributing