clumsies

Building collaborative agent memory infrastructure for distributing rules, workflows, and project context to coding agents.

[!WARNING] Work in progress. This is still a very early system. Expect rough edges, missing flows, broken corners, and backward-incompatible changes.

The problem

AI coding agents are changing the control plane of software development.

Organizations used to manage only code. Now they also need to manage the rules, constraints, and project context that shape how agents write code.

But an agent's memory lives inside its own runtime. It is not an organizational asset, and it is hard for teams to share, review, or evolve in one place. When context pressure hits, useful project rules and background can still get silently dropped.

clumsies keeps that external memory in a managed workspace. Agents activate candidate memory for the current task, retrieve only the relevant items, and store draft refinements through the same system.

Key features

• Managed agent memory. Store rules, workflows, and project context outside any single agent runtime, then keep local workspaces in sync.
• Cue-driven activation. The MCP surface is centered on activate, retrieve, and store, so agents can select task-relevant memory before reasoning instead of loading everything up front.
• Organization and project scope. Shared memory can live at the organization level, while workspaces keep their own project-specific context and rules.
• Bundle-based rollout. Bundles let teams publish a curated set of shared memory and initialize workspaces from that set.
• Agent adapters. The adapter layer installs the runtime hooks and skills needed by supported agents. Codex and Claude Code are supported today.
• Self-hosted authority. The Rust Server and PostgreSQL run in your infrastructure; Zig remains focused on CLI and MCP client surfaces.

Quick start

The macOS client currently runs from source and connects to the hosted Clumsies Server at https://app.clumsies.ai:

git clone https://github.com/lilhammerfun/clumsies.git
cd clumsies
bun install
bun run dev:macos

The build embeds the Rust daemon binary, atomically replaces ~/Applications/Clumsies.app, and launches the native AppKit/SwiftUI application from that stable path.

For local Server and Web Admin development, start PostgreSQL, the deterministic fake OIDC provider, and Server with:

bun run dev:server

The fake provider is for local Server development only; production uses the organization's OIDC provider. The macOS app talks to the local daemon, which owns automatic draft synchronization and authenticated Server transport.

For the self-hosted configuration, see the deployment guide. The Zig CLI and MCP server can still be built separately:

zig build -Doptimize=ReleaseFast

License

MIT