@kyokasui/agentmemory
v0.3.0
Published
AgentMemory is a private, device-scoped memory service for AI coding agents. It keeps durable memories, lessons, sessions, and search available across a workstation while running the backend at the Cloudflare edge.
Readme
AgentMemory Cloud
AgentMemory is a private, device-scoped memory service for AI coding agents. It keeps durable memories, lessons, sessions, and search available across a workstation while running the backend at the Cloudflare edge.
Install in five minutes
The current preview supports Windows native and Linux native. Deploy the Worker first, then install the device client:
npm install --global @kyokasui/agentmemory
agentmemory setupSetup prompts for the Worker URL and a hidden device token or admin enrollment key, detects supported agents, previews changes, installs MCP/skills/hooks and the packaged global agent instructions idempotently, and verifies a save/search/delete roundtrip. Admin keys are never stored. For automation, set AGENTMEMORY_URL plus AGENTMEMORY_SECRET or AGENTMEMORY_ADMIN_KEY, then run agentmemory setup --non-interactive --yes --json. Use --no-global-instructions only when you explicitly do not want the global instruction contract installed.
Global instructions are installed only for detected supported hosts: Codex (~/.codex/AGENTS.md), OpenCode ($XDG_CONFIG_HOME/opencode/AGENTS.md), Gemini CLI and Antigravity (~/.gemini/GEMINI.md), and Crush (~/.config/AGENTS.md). Existing regular files are backed up and preserved with one managed block; unrelated symlinks are refused safely. agentmemory verify --json checks the source hash, ownership, and every configured host target.
Supported agents
Codex, OpenCode, Crush, Gemini CLI, and Antigravity are supported on Windows native and Linux native. See the generated support matrix for native events, formats, and host limitations.
OpenCode 1.18.x registers the local bridge directly as mcp.agentmemory with type: "local" and enabled: true. Codex expresses native hook timeouts in seconds, so the 400 ms runtime policy is represented by a 1-second host timeout; SessionEnd is capped by Codex at 3 seconds. The bridge and plugin keep the actual AgentMemory network watchdog fail-open at 400 ms.
Privacy promise
Metadata-only capture is the default. Hook payloads exclude prompts, tool arguments, shell commands, file contents, transcript paths, environment variables, tokens, and device secrets. Hooks fail open if AgentMemory is unavailable.
Verify
agentmemory verify --jsonDocumentation
- Install in five minutes
- Connect an agent
- Verify the installation
- Use AgentMemory
- Operate AgentMemory
- Build with AgentMemory
- Reference
Backend checks: npm run types, npm run typecheck, npm test, npm run lint, npm run docs:check, npm run routes:check, npm run schema:check, npm run skills:check, npm run adapters:check, npm run hooks:check, npm run security:check, and npm run deploy:dry.
