whatisgithub

What is memforks?

memforks-dev/memforks — explained in plain English

Analysis updated 2026-05-18

85Audience · developerComplexity · 5/5LicenseSetup · hard

In one sentence

Version-control style memory for AI agents, with branching, forking, and merge conflict resolution anchored on the Sui blockchain.

Mindmap

mindmap
  root((memforks))
    What it does
      Branchable agent memory
      Fork and merge memories
      Audit trail per commit
    Tech stack
      Sui blockchain
      Walrus storage
      SEAL encryption
    Use cases
      Parallel agent runs
      Reasoning audit trail
      Conflict resolution
    Audience
      AI agent builders
      Blockchain developers
    Status
      Testnet only
      Code not yet released

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give AI agents a branching memory graph they can fork to test risky reasoning paths.

USE CASE 2

Run multiple agents in parallel with isolated memory branches, then merge results.

USE CASE 3

Audit exactly which memory commit produced a given agent conclusion.

What is it built with?

SuiWalrusMemWalSEAL

How does it compare?

memforks-dev/memforksbryanyzhu/agentic-ai-system-courseeasychen/markmark
Stars858585
LanguageShellSwift
Setup difficultyhardeasyeasy
Complexity5/52/51/5
Audiencedevelopergeneralwriter

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Full open-source SDK and CLI have not shipped yet, only testnet demo objects are available.

Free to use, modify, and distribute, including commercially, as long as you keep the copyright and license notice.

So what is it?

MemForks applies version control concepts, similar to how Git manages code history, to the memory that AI agents build up as they work. Today most AI agent frameworks store memory as a flat list of things the agent has recorded, with no way to branch off and explore a risky line of reasoning without affecting the main memory, no way to run multiple agents in parallel with isolated state, and no structured way to reconcile conflicting memories when agents merge their work back together. MemForks is designed to solve those problems. The core model looks like a Git commit graph: memory has a main branch, you can create forks to explore alternative hypotheses, parallel agents each work on their own branch, and when work is ready to merge, a resolution process settles conflicts using typed rules rather than simply letting the last write overwrite everything. Every conclusion can be traced back to the specific commit that introduced it, making the agent's reasoning auditable. The system is built on top of a blockchain called Sui, which provides cryptographic anchoring and finality for merges. Memory blobs are stored using two related projects: MemWal for retrieval and Walrus for underlying blob storage, with SEAL handling encryption. The merge resolution step involves a group of attestors who sign off on how a conflict is resolved before the result is finalized on-chain. At the time of writing, the protocol is deployed on Sui testnet and the repository includes links to live on-chain objects and transactions showing a completed branch-merge cycle. However, the full open-source code release, including the TypeScript SDK, command-line tool, framework adapters for LangGraph and Vercel AI SDK, and a visual graph explorer, has not yet shipped. The README describes these as coming soon and asks visitors to watch the repository for the release notification. The project is Apache 2.0 licensed.

Copy-paste prompts

Prompt 1
Explain how MemForks branch-and-merge model differs from a flat agent memory log.
Prompt 2
Walk me through how MemWal and Walrus store memory blobs for MemForks.
Prompt 3
Show me the Sui testnet transactions in this repo that demonstrate a completed merge.
Prompt 4
What will the TypeScript SDK and LangGraph adapter let me do once released?

Frequently asked questions

What is memforks?

Version-control style memory for AI agents, with branching, forking, and merge conflict resolution anchored on the Sui blockchain.

What license does memforks use?

Free to use, modify, and distribute, including commercially, as long as you keep the copyright and license notice.

How hard is memforks to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is memforks for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.