aigpt docs

Overview

MCP server for AI memory. Reads/writes core.md and memory.md. Nothing more.

Design

AI decides, tool records
File I/O only, no database
4 MCP tools: read_core, read_memory, save_memory, compress
Simple, unbreakable, long-lasting

MCP Tools

Tool	Args	Description
read_core	none	Returns core.md content
read_memory	none	Returns memory.md content
save_memory	content: string	Overwrites memory.md
compress	conversation: string	Reads memory.md + conversation, writes compressed result to memory.md

compress note: AI decides what to keep/discard. Tool just writes.

Data

~/.config/aigpt/
├── core.md      ← read only (identity, settings)
└── memory.md    ← read/write (memories, grows over time)

Architecture

src/
├── mcp/server.rs   ← JSON-RPC over stdio
├── core/reader.rs  ← read core.md, memory.md
├── core/writer.rs  ← write memory.md
└── main.rs         ← CLI + MCP server

Compression Rules

When compress is called, AI should:

Keep facts and decisions
Discard procedures and processes
Resolve contradictions (keep newer)
Don't duplicate core.md content

Usage

aigpt serve          # start MCP server
aigpt read-core      # CLI: read core.md
aigpt read-memory    # CLI: read memory.md
aigpt save-memory "content"  # CLI: write memory.md

Tech

Rust, MCP (JSON-RPC over stdio), file I/O only

History

Previous versions (v0.1-v0.3) had multi-layer architecture with SQLite, Big Five personality analysis, relationship inference, gamification, and companion systems. Rewritten to current simple design. Old docs preserved in docs/archive/.

1.7 KiB Raw Blame History