AddAI

AddAI is a local context memory system for ADHD-friendly lane switching and AI coding handoffs. It stores focus lanes, project manifests, and memory cards in plain files on your machine.

No cloud service is required. Core commands do not call an LLM.

Install

npm install
npm link
addai doctor

The CLI entrypoint is still nexus-memory.js, so old usage continues to work:

node nexus-memory.js doctor

Storage

AddAI stores global data under ~/.addai/ by default:

~/.addai/
  config.yaml
  logs/
    lane-graph.json
    associative-ledger.jsonl
    edit-ledger.jsonl
  memories/
    projects/
    ideas/
    people/
    patterns/
    decisions/

Set ADDAI_HOME to use another location:

ADDAI_HOME=/tmp/addai-dev addai doctor

On Windows PowerShell:

$env:ADDAI_HOME="C:\tmp\addai-dev"; addai doctor

Lane Commands

Save a landing pad for a lane:

addai snap rivaldrop "eval loop" "composite below trigger"

List saved lanes:

addai list

Resume a lane:

addai resume rivaldrop

Create an associative edge between lanes:

addai edge rivaldrop neighborhoodos "same scoring pattern"

Export the lane graph and edge ledger:

addai export

Check local setup:

addai doctor

Project Manifests

Initialize global AddAI home:

addai init

Initialize project-local context files in the current repo:

addai init-project --name "AddAI" --slug addai

This creates:

.addai/
  project.yaml
  context.md
  decisions.md
  open-questions.md
  related.md
  agent-instructions.md

Memory Cards

Create or append to a memory card:

addai remember idea memory-linked-edits "Edits should link to memory handles so future agents can recover context."
addai remember project neighborhoodos "NeighborhoodOS runs today and should not be described as only a concept."
addai remember person leslie "Leslie is connected to the LAMP tool library deployment."

Memory cards are Markdown files with YAML frontmatter:

---
id: memory:ideas:memory-linked-edits
type: idea
title: Memory Linked Edits
scope: private
status: active
last_touched: 2026-06-01
---

Edits should link to memory handles so future agents can recover context.

Current Scope

Implemented commands:

snap, resume, list, edge, export, status, doctor, init, init-project, remember

Later phases will add link ledgers, context bundles, edit summaries, search, a local API, and PWA wiring.