Skip to content

smara-io/smara

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 

Repository files navigation


The Problem

Every AI tool has its own isolated memory. Tell Claude Code you prefer Python — switch to Cursor, it has no idea. Open Codex — starts from scratch. You repeat yourself endlessly: "we use Postgres", "deploy to Fly.io", "the API is at /v2".

CLAUDE.md and .cursorrules files are manual, fragile, and don't share context across tools.

The Fix

Smara gives your AI tools a shared memory that works everywhere:

You code normally in any tool
       ↓
Smara silently captures decisions, preferences, architecture choices
       ↓
Next session — in any tool — your AI already knows

Install in 30 seconds

npx @smara/mcp-server --init

Or add to your MCP config manually:

{
  "mcpServers": {
    "smara": {
      "command": "npx",
      "args": ["-y", "@smara/mcp-server"],
      "env": {
        "SMARA_API_KEY": "your-key-here"
      }
    }
  }
}

Works with Claude Code (~/.claude/mcp_config.json), Cursor (.cursor/mcp.json), Windsurf (~/.codeium/windsurf/mcp_config.json), and any MCP-compatible client.

Get your free API key at smara.io — no credit card required.


Why Smara?

Feature Smara CLAUDE.md / .cursorrules RAG / Vector DB
Cross-tool memory Yes No (per-tool) Manual
Auto-capture context Yes Manual editing Manual indexing
Ebbinghaus decay scoring Yes No No
Contradiction detection Yes No No
Semantic search Yes No Yes
Teams & shared context Yes No No
Source tagging Yes No Partial
Zero config Yes Needs maintenance Complex setup

How It Works

How Smara works across tools

Ebbinghaus Decay

Memory relevance is scored using Ebbinghaus forgetting curves:

R = e^(-t/S)

Where t is time elapsed and S is memory strength (based on importance + access frequency). Important, frequently-used facts stay strong. Old noise fades naturally. No manual cleanup needed.

Contradiction Detection

Store "we use Postgres" today, then "we migrated to MySQL" next month — Smara detects the contradiction, soft-deletes the old fact, and keeps the new one. Your AI never gets confused by stale context.

Cross-Tool Context

A decision captured in Claude Code is instantly available in Cursor, Windsurf, Codex, or any connected tool. Every memory is tagged with its source — filter by tool or see everything.


REST API

Three endpoints. That's it.

Store a memory

curl -X POST https://api.smara.io/v1/memories \
  -H "Authorization: Bearer $SMARA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "user_42",
    "fact": "Prefers Python over TypeScript for backend work",
    "importance": 0.8,
    "source": "claude-code"
  }'

Returns "action": "stored", "duplicate" (cosine >= 0.985), or "replaced" (contradiction detected).

Search memories

curl "https://api.smara.io/v1/memories/search?user_id=user_42&q=language+preferences" \
  -H "Authorization: Bearer $SMARA_API_KEY"

Results ranked by semantic similarity × Ebbinghaus decay. Recent + relevant beats old + relevant.

Get context

curl "https://api.smara.io/v1/users/user_42/context?q=preferences" \
  -H "Authorization: Bearer $SMARA_API_KEY"

Returns pre-formatted context ready to inject into LLM system prompts.

Full API reference: api.smara.io/docs


Try It Live

smara.io/playground — interactive demo where you can store, recall, and see contradiction detection in action. No signup required.

Smara API Playground


Integrations

Tool Method Status
Claude Code MCP server Live
Cursor MCP server Live
Windsurf MCP server Live
CrewAI Python SDK smara-crewai
LangChain Python SDK smara-langchain
Paperclip Plugin paperclip-plugin
OpenAI / Codex REST API Use endpoints directly

Pricing

Free Developer Pro
Memories 10,000 200,000 2,000,000
Teams 1 team / 3 members 3 teams / 10 members Unlimited / 50 members
AI Agents 2 10 + 5 custom skills Unlimited
Price $0 $19/mo $99/mo

Compare: Mem0 Pro $249/mo · Letta Max $200/mo · Zep Flex+ $475/mo

Get your free API key — no credit card required


Self-Hosting

git clone https://github.com/smara-io/api.git && cd api
VOYAGE_API_KEY=your-key docker compose up -d

Runs on localhost:3011. Requires PostgreSQL 15+ with pgvector and a Voyage AI key for embeddings.

See smara-io/api for full setup instructions.


Packages

Package Description
@smara/mcp-server MCP server for Claude Code, Cursor, Windsurf
smara-io/api Self-hostable API server (Docker + manual)
smara-io/paperclip-plugin Paperclip AI plugin

Learn More


Feedback

Smara is in active development. We read every submission:


smaraस्मर — the act of remembrance

Website · API Docs · Playground · npm · Twitter

MIT License

About

Persistent memory for AI tools. Give Claude, Cursor, and Codex shared context that survives across sessions.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors