memctl v0.1.0 - First Public Beta
First public beta of memctl, a cloud MCP server that gives AI coding agents persistent, shared memory across sessions, machines, and IDEs. Ships with 11 MCP tools, hybrid search, a web dashboard, support for 12+ agents, team collaboration, and self-hosting.
Matthew Meszaros
Features
Changelog - v0.1.0 (Beta)
Released: 2026-02-28
The first public beta of memctl. Persistent, shared memory for AI coding agents.
Features
- 11 MCP tools with 90+ actions - memory, memory_advanced, memory_lifecycle, context, context_config, session, activity, branch, repo, org, import_export
- Hybrid search - FTS5 full-text search combined with vector embeddings (all-MiniLM-L6-v2, 384 dimensions) using Reciprocal Rank Fusion
- 9 built-in context types - coding_style, folder_structure, file_map, architecture, workflow, testing, branch_plan, constraints, lessons_learned, plus custom types
- Context bootstrapping - Delta sync, smart retrieval, token budgeting, and per-turn context injection
- Session management - Conflict detection, automatic handoff tracking, claims system for memory key reservation
- Branch-scoped context - Implementation plans and memories scoped to feature branches
- Content quality filter - Blocks noise like shell dumps, raw diffs, and JSON blobs from being stored
- Offline-first CLI - Local SQLite cache with incremental delta sync and pending write queue
- ETag support - Conditional requests returning 304 when nothing changed
- Import/export - Bulk import from AGENTS.md, .cursorrules, copilot-instructions.md, and JSON
- Memory snapshots - Point-in-time backups of project memory
- Version history - Track changes to individual memories over time
- Relevance scoring - Priority, usage frequency, recency, feedback, and pin status combined into a single score
- Memory graph visualization - Visual exploration of related memories
Agent Support
- Claude Code
- Cursor
- Windsurf
- Cline
- Roo Code
- Codex
- OpenCode
- Amazon Q
- JetBrains IDEs
- Continue
- Zed
- Auto-initialization wizard via
memctl initwith per-agent config generation
Dashboard
- Organization management - Create orgs, invite members, assign roles (owner, admin, member)
- Project management - Create projects, assign members, configure settings
- Memory browser - View, search, edit, pin, archive, and organize memories
- Activity feed - Server-rendered first 50 items with cursor-based infinite scroll
- Health metrics - Memory quality scoring and monitoring
- Hygiene tools - Deduplication detection and cleanup
- Usage analytics - Storage and API consumption tracking
- API token management - Generate, rotate, and revoke Bearer tokens
- Loading skeletons - Skeleton states on all dashboard pages during navigation
Auth and Billing
- GitHub OAuth via better-auth
- Magic link auth for admin access
- Dev auth bypass for local development without OAuth
- Stripe integration - 6 pricing tiers (Free, Lite, Pro, Business, Scale, Enterprise)
- Seat-based billing - Per-member pricing on paid plans
- Self-hosted mode - Set
SELF_HOSTED=trueto disable all billing gates
Admin
- Admin dashboard - User management, org oversight, billing controls
- Changelog system - Versioned entries with markdown editor and draft/published status
- Blog system - Admin CRUD with markdown support
- Overview charts - Signup trends, MRR, referrer analytics
- Per-org overrides - Custom limits, plan overrides, suspend/ban
Infrastructure
- pnpm monorepo with Turborepo (apps/web, packages/cli, packages/db, packages/shared)
- Next.js 15 with App Router and Turbopack
- Turso (libSQL) with Drizzle ORM, 28 database tables
- Docker support - Dev (docker-compose.yml), production (multi-stage Dockerfile), self-hosted
- CI pipeline - GitHub Actions: lint, typecheck, test, build
- CLI auto-publish - npm publish on version bump via CI
- Rate limiting - Sliding-window counter scaled by plan tier (60-150 req/min)
- Background jobs - Hourly expired memory cleanup, embedding backfill every 6 hours
- SEO - Meta tags, OG images, robots.txt, dynamic sitemap
CLI Commands
npx memctl auth- Authenticate and store tokennpx memctl init- Interactive setup wizard for any MCP-compatible IDEnpx memctl doctor- Diagnostics and connectivity checksnpx memctl generate- Generate MCP configs (--claude, --cursor, --windsurf, --cline)npx memctl list- List memoriesnpx memctl search- Search memoriesnpx memctl export- Export memoriesnpx memctl import- Import memoriesnpx memctl snapshot- Create memory snapshot