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 init with 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=true to 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 token
• npx memctl init - Interactive setup wizard for any MCP-compatible IDE
• npx memctl doctor - Diagnostics and connectivity checks
• npx memctl generate - Generate MCP configs (--claude, --cursor, --windsurf, --cline)
• npx memctl list - List memories
• npx memctl search - Search memories
• npx memctl export - Export memories
• npx memctl import - Import memories
• npx memctl snapshot - Create memory snapshot