Agentos MCP server

AgentOS — Local-first persistent memory for AI coding agents

Phase 0.5 MVP: a small Rust MCP server that gives Claude Code persistent, project-scoped memory using SQLite FTS5.

Why AgentOS?

AI coding agents lose important context when a session ends. Architecture decisions, failed approaches, project conventions, and bug-fix details often have to be explained again.

AgentOS provides a small local memory layer that coding agents can access through MCP. Memories are stored in SQLite and retrieved with FTS5 keyword search—without a cloud account, embedding API, or external database.

Phase 0.5 is intentionally narrow: save explicit project memories and retrieve them in future Claude Code sessions.

Features

• Persistent memory across Claude Code sessions
• Local SQLite storage with bundled SQLite
• Fast keyword retrieval through SQLite FTS5
• Two focused MCP tools: memory.remember and memory.search
• Project isolation using the MCP server's working directory
• MCP JSON-RPC communication over standard input and output
• No telemetry, network service, cloud database, or API key

Architecture

┌─────────────────────┐
│     Claude Code     │
└──────────┬──────────┘
           │
           │ MCP JSON-RPC
           │ newline-delimited stdio
           ▼
┌─────────────────────┐
│       AgentOS       │
│                     │
│  memory.remember    │
│  memory.search      │
└──────────┬──────────┘
           │
           │ rusqlite
           ▼
┌─────────────────────┐
│   SQLite + FTS5     │
│                     │
│  Local persistence  │
│  Keyword search     │
└─────────────────────┘

SQLite is the source of truth. The FTS5 index is kept synchronized with the memories table through SQLite triggers.

Quick Start

Requirements

AgentOS currently uses a Windows-first development workflow.

Install:

• Windows 10 or Windows 11
• Rust 1.80 or newer
• Visual Studio 2022 Build Tools
• The Desktop development with C++ workload
• MSVC v143 build tools
• Windows 10 or Windows 11 SDK
• Claude Code

A separate SQLite installation is not required. AgentOS compiles and links bundled SQLite through rusqlite.

1. Clone the repository

Open PowerShell:

git clone https://github.com/OfficialTanishSharma/agentos.git
Set-Location .\agentos

2. Verify the Rust toolchain

rustc --version
cargo --version
rustup show

The active host should normally be:

x86_64-pc-windows-msvc

If required, select it explicitly:

rustup default stable-x86_64-pc-windows-msvc

3. Test and build AgentOS

cargo test
cargo build --release

The release binary will be created at:

target\release\agentos.exe

Verify it:

Get-Item .\target\release\agentos.exe

4. Connect AgentOS to Claude Code

Resolve the release binary to an absolute path:

$agentos = (Resolve-Path .\target\release\agentos.exe).Path

Register it as a project-scoped stdio MCP server:

claude mcp add --transport stdio --scope project agentos -- $agentos

Inspect the configuration and connection status:

claude mcp get agentos
claude mcp list

The expected status is:

✔ Connected

If the server is waiting for project approval, start Claude Code and approve the MCP configuration:

claude

5. Save a memory

Inside Claude Code, ask:

Call memory.remember with these values:

Shortened. The full README is on GitHub.