Skip to content

Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors

Rust

docs: clarify Pi OMP aliases

AkitaOnRailsb6dd257c611f
diff --git a/CHANGELOG.md b/CHANGELOG.md
index bff77279..208e6716 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,10 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [Unreleased]
### Added
-- Oh My Pi / OMP is now a first-class integration: `install-mcp --client omp`
- writes native `~/.omp/agent/mcp.json` config, and
- `install-hooks --agent omp` writes the TypeScript extension used for
- lifecycle capture and handoff injection.
+- Oh My Pi / OMP is now a first-class integration: `install-mcp --client pi`
+ and `--client omp` write native `~/.omp/agent/mcp.json` config, while
+ `install-hooks --agent omp` and `--agent pi` write the TypeScript extension
+ used for lifecycle capture and handoff injection.
## [0.1.3] - 2026-05-24
diff --git a/README.md b/README.md
index 3067e564..fdf273d6 100644
--- a/README.md
+++ b/README.md
@@ -49,8 +49,9 @@ priors are at the [bottom](#influences-and-prior-art).
mode. Mounted on the same axum server as MCP.
- **Multi-agent + multi-machine ready.** Supported clients: Claude
Code, Codex, OpenCode, Cursor, Claude Desktop (via `mcp-remote`),
- Gemini CLI, OpenClaw, Oh My Pi / OMP. Server runs local (loopback)
- OR on a homelab box (LAN/VPN/cloud) with bearer-token auth.
+ Gemini CLI, OpenClaw, and Oh My Pi / OMP (`pi` / `omp` aliases).
+ Server runs local (loopback) OR on a homelab box (LAN/VPN/cloud)
+ with bearer-token auth.
- **Thin-client CLI.** `ai-memory bootstrap`, `purge-project`,
`rename-project`, `lint`, `embed`, `forget-sweep`, `backup` are
all HTTP clients of the running server - never touch SQLite or
@@ -129,8 +130,8 @@ docker run -d --name ai-memory \
# 3. Wire your agent CLI in two commands. The wrapper takes care of
# mounts + auto-detecting ~/.claude/settings.json. Re-run with
-# `--agent codex`, `--agent opencode`, `--agent omp`,
-# `--client cursor`, etc.
+# `--agent codex`, `--agent opencode`, `--agent omp`/`pi`,
+# `--client cursor`, `--client pi`/`omp`, etc.
# for additional agents; full list in docs/install.md.
ai-memory install-mcp --client claude-code --apply
ai-memory install-hooks --agent claude-code --apply
diff --git a/docs/install.md b/docs/install.md
index d942638b..337acf96 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -150,8 +150,9 @@ ai-memory install-hooks --agent omp --apply \
```
Restart OMP after installing or changing the extension; extensions are
-loaded at startup. The `pi` MCP client name and `omp` hook agent name
-target the same current Oh My Pi integration surface.
+loaded at startup. The ai-memory CLI accepts `--client pi` /
+`--client omp` for MCP and `--agent omp` / `--agent pi` for hooks;
+all four target the same current Oh My Pi integration surface.
### Bind mounts vs docker cp
@@ -227,10 +228,10 @@ docker run --rm akitaonrails/ai-memory:latest \
--auth-token "$TOKEN"
```
-The curl script installer supports `--agent claude-code|codex|opencode|omp`
+The curl script installer supports `--agent claude-code|codex|opencode|omp|pi`
and `--to <dir>`; `--help` prints the full flag list. OpenCode and OMP do
not need this script installer because `install-hooks --agent opencode`
-and `install-hooks --agent omp` generate TypeScript files instead.
+and `install-hooks --agent omp` / `--agent pi` generate TypeScript files instead.
This path is friction-free when:
- You have curl + bash but not docker
diff --git a/docs/mcp-install.md b/docs/mcp-install.md
index 4fcfeaaa..5162d3e1 100644
--- a/docs/mcp-install.md
+++ b/docs/mcp-install.md
@@ -179,16 +179,18 @@ OpenClaw distinguishes transports explicitly. Use
## Oh My Pi / OMP
-**Status:** ✅ MCP supported. ✅ Lifecycle capture supported via
-`ai-memory install-hooks --agent omp --apply`.
+**Status:** ✅ MCP supported via `install-mcp --client pi` or
+`--client omp`. ✅ Lifecycle capture supported via
+`ai-memory install-hooks --agent omp --apply` or `--agent pi --apply`.
**Config file:**
- User: `~/.omp/agent/mcp.json`
- Project: `.omp/mcp.json`
The current Oh My Pi package exposes the `omp` binary and native
-`.omp` config directories. The ai-memory CLI accepts `--client pi` and
-`--client omp` as aliases for this same MCP surface.
+`.omp` config directories. The ai-memory CLI accepts `--client pi` /
+`--client omp` for MCP and `--agent omp` / `--agent pi` for lifecycle
+capture; they are aliases for this same integration surface.
```json
{
@@ -206,6 +208,8 @@ The current Oh My Pi package exposes the `omp` binary and native
```bash
ai-memory install-hooks --agent omp --apply
+# or:
+ai-memory install-hooks --agent pi --apply
```
This writes `~/.omp/agent/extensions/ai-memory.ts`, which OMP discovers
diff --git a/scripts/install-hooks.sh b/scripts/install-hooks.sh
index a9d5ded9..db74b362 100755
--- a/scripts/install-hooks.sh
+++ b/scripts/install-hooks.sh
@@ -10,8 +10,8 @@
# | bash -s -- --agent claude-code
#
# Options:
-# --agent <claude-code|codex|opencode|omp> which agent (default: claude-code;
-# opencode/omp print extension hints)
+# --agent <claude-code|codex|opencode|omp|pi> which agent (default: claude-code;
+# opencode/omp/pi print extension hints)
# --to <dir> install root (default: $HOME/.ai-memory/hooks)
# --ref <git-ref> repo ref to pull from (default: main)
#
@@ -45,9 +45,9 @@ while [[ $# -gt 0 ]]; do
done
case "$AGENT" in
- claude-code|codex|opencode|omp) ;;
+ claude-code|codex|opencode|omp|pi|oh-my-pi) ;;
*)
- echo "unsupported agent: $AGENT (expected claude-code | codex | opencode | omp)" >&2
+ echo "unsupported agent: $AGENT (expected claude-code | codex | opencode | omp | pi | oh-my-pi)" >&2
exit 64 ;;
esac
@@ -58,7 +58,7 @@ if [[ "$AGENT" == "opencode" ]]; then
exit 0
fi
-if [[ "$AGENT" == "omp" ]]; then
+if [[ "$AGENT" == "omp" || "$AGENT" == "pi" || "$AGENT" == "oh-my-pi" ]]; then
echo "OMP uses a generated TypeScript extension, not shell hook scripts."
echo "Run: ai-memory install-hooks --agent omp --apply"
echo "Then restart OMP so it loads ~/.omp/agent/extensions/ai-memory.ts."