memmy-agent

Continue the same work across DeepSeek Harness, Claude Code, Codex, and etc.

Overview · Quick Start · Technical Overview · Roadmap · Acknowledgements · Contributors

English • 简体中文

What Is Memmy?

Cross-Agent Task Continuity

Most of the Agents You're Using Can Connect to Memmy

DeepSeek Harness, OpenClaw, Hermes, Claude Code, Codex, Cursor, WorkBuddy, OpenCode, Pi...they all work!

[cross-agent-en.png]

Data Security

[Memmy data security]

How to Use Memmy

For complete installation and configuration instructions, see the Getting Started guide.

1. Desktop App (Recommended)

Download Memmy from the official website or GitHub Releases.

[!TIP] Sign up for Memmy to receive free tokens and try the complete Memory + Agent Runtime. Trial credits: Registration grants Agent task trial tokens; the current balance and usage are shown in the app. When the trial credits run out, switch to BYOK mode and use your own model API.

2. Use the memmy CLI / TUI

[Memmy TUI]

On Linux x64 or arm64 with an available systemd user session, use Node.js 22.23.4+ (22.x), 24.22.1+ (24.x), or 26.12.1+ (26.x). Other major versions are not accepted by the installer:

curl -fsSL https://raw.githubusercontent.com/MemTensor/memmy-agent/main/scripts/install.sh | bash
memmy

The installer enables the local Memory Service immediately as memmy-memory.service. The first bare memmy invocation opens the model setup wizard when needed, then enables memmy-gateway.service, waits for it to become ready, and enters the TUI. Both are systemd --user services bound to localhost and remain available after the TUI or terminal exits. They start again on later logins; the installer does not enable linger. Only the installer launcher activates this service management, so source-built Linux CLIs keep their existing behavior.

During Gateway startup, temporary HTTP 503 responses from the bootstrap endpoint are retried until the Gateway becomes ready or the startup wait times out.

Before starting or reconnecting to the Gateway, memmy refreshes a private ~/.memmy/systemd/gateway.env file (mode 0600) with configuration-referenced environment variables, common Provider credentials, and the terminal PATH. If those values change, the next bare memmy invocation restarts the user service with the new environment.

systemctl --user status memmy-memory.service
systemctl --user status memmy-gateway.service

The installer initializes Memory without changing Codex, Claude Code, Cursor, or other agents. Run memmy-memory init (all detected agents) or memmy-memory init --agent <agent> when you explicitly want to install the Memory Skill and the supported Hook/plugin for an agent.

memmy onboard                              # Configure models, providers, gateway, memory, and tools interactively
memmy onboard --defaults                   # Initialize ~/.memmy/config.yaml and the workspace with defaults
memmy status                               # Check the configuration, model, and provider
memmy agent --message "Introduce the current workspace"  # Run a single-turn task
memmy                                      # Enter the interactive TUI
memmy serve                                # Start the OpenAI-compatible API (:18990)

The minimal BYOK configuration is located at ~/.memmy/config.yaml:

agents:
  defaults:
    model: openai/gpt-4.1
    provider: openai
    timezone: "+08:00"
providers:
  openai:
    apiKey: ${OPENAI_API_KEY}

3. Use the memmy-memory CLI

Use it to access the local memory service from agents, scripts, and debugging workflows:

memmy-memory init
memmy-memory health
memmy-memory search "memory policies in this project"
memmy-memory add "a piece of knowledge worth saving"
memmy-memory get <id>

It connects to http://127.0.0.1:18960 by default. Use --url, --token, --config, --source, and --user-id to specify the service and namespace.

To run the memory service alone, without the Agent Runtime, build the CLI from source:

git clone https://github.com/MemTensor/memmy-agent.git
cd memmy-agent
npm install
npm run memory:build
mkdir -p ~/.local/bin
ln -sf "$PWD/Memory/dist/src/cli/index.js" ~/.local/bin/memmy-memory
memmy-memory install --service-only

install --service-only downloads the pinned Memory runtime, registers the user-level service, starts it, and verifies /api/v1/health, all without installing a Skill or adapter into any agent. Node.js >=20 is required; use Git Bash on Windows. npm run memory:binary packages the same CLI as a portable archive under Memory/src/cli/dist/binaries/ for the current platform, and MEMMY_MEMORY_TARGET selects another supported platform.

4. Start from the Source Code

git clone https://github.com/MemTensor/memmy-agent.git
cd memmy-agent
cp .env.example .env
npm install
npm run build
bash scripts/dev-start.sh

The script installs dependencies, builds the services, and starts the development environment. Node.js >=22 and npm are required; use Git Bash on Windows.

How Is Memmy Built?

For details about the architecture, memory service, and integration methods, see the Memmy documentation.

Roadmap

Memmy is building personal memory infrastructure, and its scope goes beyond coding Agents:

• More memory sources — expanding from AI conversations to browser activity, local documents, and eventually more devices and hardware.
• Team collaboration — planned Agent-to-Agent collaboration, letting team members' AI assistants share knowledge under privacy protection.

Acknowledgements

Memmy stands on the shoulders of a group of excellent open-source projects, and we are deeply grateful.

• OpenClaw — a pioneer of open-source personal AI assistants; its exploration of multi-platform messaging channels directly inspired Memmy's channel connection design.
• hermes-agent — the self-evolving Agent built by Nous Research; its practice in persistent memory and skill self-learning showed us that an Agent can "understand you better the more you use it".
• nanobot — grown from a minimal prototype into a fully featured open-source Agent platform; its engineering practice around the Agent loop and MCP integration provided important references for Memmy's core design.

The point of open source is to let good ideas flow, and we hope Memmy becomes part of that river.

Contributors

Thanks to every contributor who makes Memmy better ❤️