Skip to content
Productivity
Skill

/waku-memory

Connect Waku Memory, hosted cross-agent memory in Claude Code, Codex, Grok Bot, Hermes. Export Waku skills.

From plugin
waku-agent
2.2k14 skills

Claude Code

$ npx -y skills add ShenSeanChen/waku-agent --skill waku-memory --agent claude-code

SKILL.md

waku-memory.SKILL.md
name: waku-memory
description: Connect Waku Memory, hosted cross-agent memory in Claude Code, Codex, Grok Bot, Hermes. Export Waku skills.

What Waku Memory is

This app's memory is local. It lives in `~/.waku/` on this machine. Waku also writes each fact to `~/.waku/memory/`, one file per fact, so the Waku Memory importer can upload it. Waku Memory (waku.one) is a hosted memory that several agents share over MCP: a fact saved in Claude Code can be recalled in Codex, Grok Bot or this app. A fact reaches Waku Memory only when it is uploaded, so never tell the user a fact is there unless a tool's output says so.

Connecting this app

Connecting opens the user's browser, so you cannot do it for them. Tell them to type `/connect waku-memory` in the dashboard chat, or to run `waku connect waku-memory` in a terminal. It needs the MCP extra: `pip install 'waku-agent[mcp]'`. After it connects, a restart of Waku loads the `waku_memory_*` tools.

Connecting other agents

  • **Claude Code, Codex, Hermes:** point them to https://www.waku.one/docs.
  • **Grok Bot:** Settings → Plugins → add a custom connector with the URL

`https://api.waku.one/mcp` and the header `Authorization: Bearer <key>`, using a key from waku.one → Account → Keys. Its connector form takes a URL and a header, not a browser sign-in, which is why it needs the key.

  • **Muse Code or any other MCP client:** add `https://api.waku.one/mcp` as a

remote (streamable HTTP) server.

Tell the user to paste a key only into the other agent's own settings, never into this chat.

Carrying skills

`waku skill export --to claude,codex` copies Waku's skills into Claude Code's and Codex's skills folders. `--project` writes to `./.claude/skills`, which Muse Code also reads. Saving skills into Waku Memory is not available yet.

What not to claim

Don't quote prices, plans or limits; point to https://www.waku.one/docs.

Read more
@shenseanchen
Ships withwaku-agent

Your own AI assistant. On your laptop. In code you can read in an afternoon. Meet Waku — a local-first personal assistant that shows the four pillars behind every serious agent: Harness · Loop · Memory · Eval/LLM-Ops. No frameworks hiding the good parts.

Stars on GitHub

Momentum

stars in total
2.2k
Star history of ShenSeanChen/waku-agent on GitHub, a chart by star-history.com

Other skills on waku-agent.

excalidraw

excalidraw

Generate an Excalidraw whiteboard in Sean's hand-drawn video style (Excalifont, roughness 1, green signature, socials +…

new-tool

new-tool

Add a new tool to Waku the right way — schema, safe execution, deterministic eval, honest output. Use when adding or modifying…

pr-worktree

pr-worktree

Create and tear down the throwaway git worktrees used to test community PRs for waku-agent, without leaking API keys or leaving…

release

release

Cut a waku-agent release when main is ahead of the last tag. Check the gap, bump the version, tag, confirm PyPI, announce. Use…

review-pr

review-pr

Walk Sean through an incoming waku-agent PR or issue and present it his way — four fixed sections: what this is, why it matters,…

ship

ship

Commit and push the current work properly — lint, run the release gate, write a detailed commit message, push to GitHub. Use…

More skills from other plugins.

i-have-adhd

i-have-adhd

Shape output for a reader with ADHD: lead with the next action, number multi-step work, restate state across turns, suppress…

@ayghri@ayghriInstall Skill
ab-test-analysis

ab-test-analysis

Analyze A/B test results with statistical significance, sample size validation, confidence intervals, and ship/extend/stop…

@phuryn@phurynInstall Skill
distilly

distilly

Set up the owner profile so a personal agent knows who it works for (first-run setup, \"get to know me\"), or distill colleague,…

Questions about waku-memory.

Which coding agents can use waku-memory?
waku-memory installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.