{
  "markdown": "<div align=\"center\">\n\n# ✨ Clarik\n\n### Clarity and memory for Claude. One install.\n\n[![NPM Version](https://img.shields.io/npm/v/clarik?style=flat-square&color=7c3aed)](https://npmjs.com/package/clarik)\n[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)\n[![Platform](https://img.shields.io/badge/platform-Mac%20%7C%20Windows%20%7C%20Linux-brightgreen?style=flat-square)](https://clarik.dev)\n\n**Claude forgets everything between sessions. Clarik fixes that.**\n\nMemory that persists · Context that stays lean · Sessions that never die\n\n[Get Started](#-quick-start) · [All 20 Tools](#-all-20-tools) · [How It Saves You Money](#-token-savings) · [Go Pro](https://adshieldpro.gumroad.com/l/ClaricRPCFramework)\n\n</div>\n\n---\n\n## 🚀 Quick Start\n\n```bash\nnpx clarik install\n```\n\nThat's it. Clarik detects Claude Desktop and Claude Code, configures both,\nand starts working silently in the background.\n\n```\n╔═══════════════════════════════════════╗\n║           Welcome to Clarik           ║\n║   Clarity and memory for Claude.      ║\n╚═══════════════════════════════════════╝\n\n✅ Detected: Claude Desktop\n✅ Detected: Claude Code\n✅ Checking compatibility...\n✅ Done. Clarik is active.\n```\n\nOpen Claude and start chatting. Clarik remembers everything.\n\n---\n\n## 💡 What It Does\n\nClarik is an [MCP server](https://modelcontextprotocol.io) that silently fixes the biggest problems developers have with Claude:\n\n| Problem | How Clarik Fixes It |\n|---------|-------------------|\n| 🧠 Claude forgets everything between sessions | **Persistent memory** — facts, decisions, and gotchas survive forever |\n| 📄 Context fills up and quality drops | **Intelligent injection** — only the most relevant memories are loaded |\n| 💸 Repeating context wastes tokens | **Token optimization** — saves $47–73/month on API costs |\n| 🔄 Lost progress when context fills up | **Checkpoints** — save and resume exactly where you left off |\n| 🗂️ Memories from one project leak into another | **Project isolation** — each repo has its own memory space |\n| ⚠️ Claude edits files it shouldn't | **Repo guard** — protected files require your confirmation |\n| 🤔 Claude assumes instead of asking | **Assumption checker** — flags unverified claims |\n\n---\n\n## 🔧 All 20 Tools\n\n### Free Tools (no license needed)\n\n| Tool | What It Does |\n|------|-------------|\n| `clarik_memory_learn` | Extract and store facts from conversations. Strips thinking blocks. |\n| `clarik_memory_recall` | Retrieve relevant memories ranked by relevance, recency, and importance. |\n| `clarik_memory_list` | Show all memories for the current project. |\n| `clarik_memory_edit` | Update a specific memory fact. |\n| `clarik_memory_clear` | Clear memories by category or all. |\n| `clarik_context_trim` | Intelligent memory injection within a token budget. |\n| `clarik_checkpoint_save` | Save a structured snapshot of your session state. |\n| `clarik_checkpoint_resume` | Resume from a checkpoint — pick up exactly where you left off. |\n\n### Pro Tools ($20 lifetime)\n\n| Tool | What It Does |\n|------|-------------|\n| `clarik_project_index` | File-to-purpose map — Claude understands your entire codebase. |\n| `clarik_token_monitor` | Live token usage tracking. Warns at 70% context. |\n| `clarik_memory_archive` | Move stale memories to archive. Keeps active memory fast. |\n| `clarik_conflict_resolver` | Surface and resolve contradicting memories. |\n| `clarik_change_scope_guard` | Protected file confirmation before edits. |\n| `clarik_assumption_checker` | Flag when Claude assumes instead of asking. |\n| `clarik_diff_reviewer` | Structured diff review with explanations. |\n| `clarik_hallucination_detector` | Cross-check claims against your actual code. |\n| `clarik_decision_timeline` | Track architectural decisions with dates and reasons. |\n| `clarik_prompt_library` | Save and reuse prompt templates. |\n| `clarik_session_search` | Full-text search across past sessions. |\n| `clarik_export_session` | Export session data as JSON or Markdown. |\n\n---\n\n## 💰 Token Savings\n\nClarik's intelligent memory injection means Claude processes fewer redundant tokens.\n\n### Real Numbers (Sonnet 4.6 at $3/M input tokens)\n\n| | Without Clarik | With Clarik |\n|--|---------------|-------------|\n| Input tokens/session | ~800K | ~320K |\n| Cost per session | ~$3.90 | ~$1.50 |\n| **Monthly cost (20 days)** | **~$78/mo** | **~$5–31/mo** |\n| **Monthly savings** | — | **$47–73/mo** |\n\n```\nClarik Pro costs $20 once.\nSaves $47–73/month.\nPays for itself in 8 days.\n```\n\n---\n\n## 🏷️ Pricing\n\n| Tier | Price | What You Get |\n|------|-------|-------------|\n| **Free** | $0 forever | 8 core tools — memory, context, checkpoints |\n| **Pro Lifetime** | $20 | All 20 tools. One payment. Forever. |\n| **Pro Monthly** | $8/mo | All 20 tools. Cancel anytime. |\n\n<p align=\"center\">\n  <a href=\"https://adshieldpro.gumroad.com/l/ClaricRPCFramework\"><strong>→ Get Clarik Pro</strong></a>\n</p>\n\nAlready have a key?\n\n```bash\nnpx clarik activate YOUR-KEY\n```\n\n---\n\n## 🛡️ Safe Modes\n\nClarik includes four safety modes to match your workflow:\n\n| Mode | Memory | Guards | Best For |\n|------|--------|--------|----------|\n| **Safe** (default) | ✅ On | ✅ Active | Normal development |\n| **Strict** | ✅ On | 🔒 Confirm all | Production code, sensitive repos |\n| **Minimal** | ❌ Off | ❌ Off | Maximum privacy, quick tasks |\n| **Creative** | ✅ On | 🟡 Relaxed | Prototyping, exploration |\n\n---\n\n## 🖥️ CLI Commands\n\n```bash\nnpx clarik install          # Install into Claude Desktop + Claude Code\nnpx clarik activate KEY     # Unlock Pro tools with license key\nnpx clarik status           # Show plan, tools, savings, grace period\nnpx clarik upgrade          # Open clarik.dev/pro in browser\nnpx clarik uninstall        # Clean removal from all configs\n```\n\n---\n\n## 🔒 Privacy & Data\n\n**Your data never leaves your machine.**\n\n- All memory stored locally in `~/.clarik/`\n- No telemetry, no analytics server, no cloud sync\n- No data transmitted except to Anthropic's API using **your own API key**\n- You own your memory files — they're plain JSON you can read, edit, or delete\n- License validation is the only network call (Gumroad, once per 24 hours)\n\n---\n\n## ❓ FAQ\n\n### Does Clarik send my code anywhere?\n**No.** Everything stays on your machine. Clarik stores memories as local JSON files.\nThe only network request is license validation via Gumroad (Pro users, once/day).\n\n### Does it work with Claude Desktop and Claude Code?\n**Yes.** The installer detects and configures both automatically.\n\n### What happens when my context fills up?\nClarik can save a **checkpoint** of your current session — goal, progress, decisions,\nnext steps. Start a fresh session and resume instantly with `clarik_checkpoint_resume`.\n\n### Can I use it offline?\n**Yes.** Free tools work offline always. Pro tools have a 5-day offline grace period\nafter your last successful license check.\n\n### Does it work on Windows?\n**Yes.** Full Windows support with automatic `cmd /c` wrapper for stdio compatibility.\nAlso works on macOS and Linux.\n\n### Will it conflict with other MCP servers?\n**No.** All tools are prefixed with `clarik_` to prevent naming conflicts.\n\n### Can I see what Clarik has memorized?\n**Yes.** Use `clarik_memory_list` to see all stored memories, or browse the JSON\nfiles directly in `~/.clarik/projects/`.\n\n### How do I delete my data?\n```bash\nnpx clarik uninstall        # Remove from Claude configs\nrm -rf ~/.clarik/           # Delete all stored data\n```\n\n---\n\n## 🔧 Compatibility\n\n| Platform | Status |\n|----------|--------|\n| macOS | ✅ Fully supported |\n| Windows | ✅ Fully supported (cmd /c wrapper) |\n| Linux | ✅ Fully supported |\n| Claude Desktop | ✅ Auto-configured |\n| Claude Code | ✅ Auto-configured |\n\n### Known Issues\n\n- **macOS beta**: MCP connections may be unstable on macOS beta releases.\n  The installer will warn you if a beta version is detected.\n- **Transport**: Clarik uses stdio transport only. SSE and HTTP transports\n  are not supported due to known MCP compatibility issues.\n\n---\n\n## 🔍 Troubleshooting\n\n### Clarik tools don't appear in Claude\n\n1. Make sure the install completed successfully: `npx clarik status`\n2. Restart Claude Desktop / Claude Code\n3. Check that the MCP config file was written correctly:\n   - Mac: `~/Library/Application Support/Claude/claude_desktop_config.json`\n   - Windows: `%APPDATA%/Claude/claude_desktop_config.json`\n   - Linux: `~/.config/Claude/claude_desktop_config.json`\n\n### \"Connection lost\" or frequent disconnects\n\nClarik includes a 30-second heartbeat ping to keep the connection alive.\nIf you still experience disconnects:\n1. Update Claude Desktop to the latest version\n2. Avoid macOS beta releases if possible\n3. Check `~/.clarik/` directory permissions\n\n### License activation fails\n\n1. Check your internet connection\n2. Verify the key format: `CLARIK-XXXX-XXXX-XXXX`\n3. Try again — Gumroad's API occasionally has brief outages\n4. Pro tools work offline for 5 days after last successful check\n\n---\n\n## 📊 How Memory Works\n\n### What Clarik Learns\n- ✅ Stack and framework choices (\"We're using Next.js 14 with App Router\")\n- ✅ Architectural decisions (\"Moved from REST to tRPC\")\n- ✅ File purposes (\"lib/auth.ts handles JWT and sessions\")\n- ✅ Gotchas and warnings (\"Don't use the v2 API — it's broken\")\n- ✅ User-confirmed facts\n\n### What Clarik Never Learns\n- ❌ Thinking blocks (`<thinking>`, `<antml-thinking>`)\n- ❌ Chain-of-thought traces\n- ❌ Speculative guesses\n- ❌ Content before a user correction\n\n### Memory Ranking\n\nWhen recalling memories, Clarik scores each fact:\n\n```\nscore = (relevance × 0.5) + (recency × 0.3) + (importance × 0.2)\n```\n\nOnly the highest-scoring facts are injected into context — never everything at once.\n\n### Project Isolation\n\nEach project gets its own memory space, derived from:\n```\ngit remote URL → workspace root → package.json name\n```\n\nReact project memories never appear in your Python project.\n\n---\n\n## Legal\n\nClarik is an independent, community-built tool.\nIt is not affiliated with, endorsed by, or associated\nwith Anthropic PBC in any way.\n\nClaude® is a registered trademark of Anthropic PBC.\nAll references to Claude, Claude Desktop, and Claude Code\nare for compatibility identification purposes only.\n\nToken cost savings are estimates based on typical developer\nusage patterns. Actual savings depend on your workflow,\nmodel choice, and usage volume.\n\nClarik stores all data locally on your device.\nNo data is transmitted to any server except the Anthropic\nAPI using your own API key.\n\nProvided as-is without warranty of any kind.\n\nFull terms: [https://clarik.dev/terms](https://clarik.dev/terms)\n\n---\n\n<div align=\"center\">\n\n**Built for developers who use Claude every day.**\n\n[Get Started](https://npmjs.com/package/clarik) · [Go Pro](https://adshieldpro.gumroad.com/l/ClaricRPCFramework) · [Report Issues](https://github.com/clarik-dev/clarik/issues)\n\n</div>\n",
  "bytes": 10876,
  "sha": "61e07df268848084584e7c77bbdb90d339f532757a2503d7fbbb6d75aa6a8128",
  "repo_slug": "mikerichardmail/clarik-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mikerichardmail_clarik_mcp_ser_8a05a2ac/readme"
}