The Collaborative Memory Platform for Agent Coding
Share, review, and evolve organizational memory assets across engineering teams and coding agents.
AI coding agents are changing the control plane of software development.
Engineering organizations used to manage only code in Git repositories. In the agentic era, teams must also manage the architectural rules, domain constraints, and project context that steer how AI agents write and refactor code.
Today, agent memory is trapped inside isolated model sessions or local markdown files. It cannot be peer-reviewed, shared across teammates, or synchronized across agent runs. When context limits hit, critical project guidelines are silently dropped.
Clumsies is the collaborative memory platform for agent coding. It treats agent memory as a first-class, versioned organizational asset — enabling human engineers and autonomous agents to build, review, and activate shared knowledge seamlessly.
- Memory as a Team Asset (Git-Semantic Context): Rules, workflows, and project context live as first-class Markdown-backed Memory objects in Org and Project scopes. Changes are proposed as Drafts, verified through Peer Reviews, and merged atomically into immutable Commit history.
- Hybrid Retrieval & Precise Activation: Combines SQLite FTS5 BM25 text search, local dense vector embeddings, Reciprocal Rank Fusion (RRF), and Cross-Encoder reranking. Agents retrieve task-relevant fragments on demand without exhausting token budgets.
- Agent-Native Asynchronous Kanban: Agents autonomously claim tasks (
begin_work), build dependency DAGs, evaluate blocking predicates, and record structured verification steps. Human approval gates (approve_closure) ensure only verified work transitions to Done. - Pure MCP & Lifecycle Hooks: Out-of-the-box integration for Google Antigravity, Claude Code, OpenAI Codex, opencode, and DeepSeek Harness (dsh) via a single signed Rust daemon (
clumsiesd) with zero thin-skill pollution. - Self-Hosted Authority: Run the Rust Server and PostgreSQL in your own infrastructure with organization OIDC, while the local resident daemon owns fast local state and XPC transport.
| Agent Host | Protocol Surface | Managed Files | Supported Lifecycle |
|---|---|---|---|
| Google Antigravity | MCP + Lifecycle Hook | .mcp.json, .agents/hooks.json |
PreInvocation, Stop (Decision Probe) |
| Claude Code | MCP + Lifecycle Hook | .mcp.json, .claude/hooks.json |
PreInvocation, PostInvocation |
| OpenAI Codex | MCP + Config Hook | codex.json, .codex/hooks/ |
Pre/Post Execution |
| opencode | MCP Server | .opencode/mcp.json |
Task Dispatch |
| DeepSeek Harness (dsh) | Hook Bridge | .dsh/hooks/ |
Run Telemetry & Session Binding |
- Download the latest release from Releases.
- Move
Clumsies.appto/Applicationsor~/Applications. - Open
Clumsies.app. It automatically provisions the resident launchd daemon (ai.clumsies.daemon) and connects to your organization server. - Toggle your desired Coding Agent adapters in Project Settings → Coding Agents.
# Clone repository
git clone https://github.com/lilhammerfun/clumsies.git
cd clumsies
# Install dependencies and launch native macOS App
bun install
bun run dev:macosFor local server development:
# Start PostgreSQL, fake OIDC provider, and the Rust Server
bun run dev:serverFull documentation is available at docs.clumsies.ai.
MIT License © 2026 Clumsies Lab