67 lines
1.7 KiB
Markdown
67 lines
1.7 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
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/.
|