Do SOUL Alaya banner
tdwhere123 tdwhere123

Do SOUL Alaya

Development community

Description

The local-first memory plane for CLI coding agents. Codex and Claude Code attach via MCP; SQLite-backed, evidence-gated, no GUI. Cross-session memory that the agent proposes and a governance gate decides.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

**English** | [简体中文](README.zh-CN.md)

Do-SOUL Alaya

*A local-first memory plane for CLI coding agents.*

[![status](https://img.shields.io/badge/status-v0.3.11--implementation--checkpoint-informational?style=flat-square)](#where-this-is-going) [![license](https://img.shields.io/badge/license-AGPL--3.0-blue?style=flat-square)](LICENSE) [![evidence](https://img.shields.io/badge/evidence-full--bench--pending-yellow?style=flat-square)](#where-this-is-going) [![node](https://img.shields.io/badge/node-%E2%89%A524-339933?style=flat-square&logo=node.js&logoColor=white)](#quickstart) [![pnpm](https://img.shields.io/badge/pnpm-%E2%89%A59-F69220?style=flat-square&logo=pnpm&logoColor=white)](#quickstart) [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?style=flat-square&logo=typescript&logoColor=white)](#architecture-at-a-glance) [![SQLite](https://img.shields.io/badge/SQLite-WAL-003B57?style=flat-square&logo=sqlite&logoColor=white)](#architecture-at-a-glance) [![MCP](https://img.shields.io/badge/MCP-stdio-7B61FF?style=flat-square)](#surfaces-mcp--cli)

[**The problem**](#the-problem) · [**Design grammar**](#how-i-think-about-memory) · [**Memory's lifecycle**](#memorys-lifecycle) · [**Architecture**](#architecture-at-a-glance) · [**Quickstart**](#quickstart) · [**Roadmap**](#where-this-is-going)


The problem

A CLI coding agent's memory is a session: it forgets when the terminal closes. Two agents on the same project don't share what they learned. Pasting context manually scales to about one project before it stops working.

You can patch this with a vector database, but a vector DB answers *"what's similar to this string"* — not *"what is true about this project"*. Similarity is not truth. Embedding is not evidence. A recall that ranks by cosine distance can be fluent, confident, and wrong, and the agent will follow it.

Memory is not a single problem. It has phases — **perception, gove