Skip to content

armgit / mem0

Public Imported from GitHub
0

The Memory Layer for AI Agents - Drop-in memory infrastructure for AI agents and apps. Context that persists. Built for production.

feat(cli): add mem0 whoami + mem0 agent-rush subcommands (#5199)

Mragank Shekharedd1b3e2f236
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 0f9b89a2c..94686f614 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -15,6 +15,9 @@ on:
- 'tests/**'
- 'embedchain/**'
- 'pyproject.toml'
+ - 'cli/**'
+ - 'docs/**'
+ - '.github/workflows/**'
jobs:
changelog_check:
diff --git a/cli/node/CHANGELOG.md b/cli/node/CHANGELOG.md
new file mode 100644
index 000000000..713ce451d
--- /dev/null
+++ b/cli/node/CHANGELOG.md
@@ -0,0 +1,36 @@
+# Changelog
+
+All notable changes to `@mem0/cli` are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.7] — 2026-05-20
+
+### Added
+
+- `mem0 whoami` — print the active agent's `default_user_id` (the AGENTRUSH
+ leaderboard identifier). Reads from local config, no network call.
+- `mem0 agent-rush <add | search>` — subcommand group that wraps the new
+ `/v1/agent-rush/` platform endpoints for the 7-day AGENTRUSH game. Project
+ routing is implicit (resolved server-side); no flags exposed. Pretty-prints
+ platform error codes into actionable hints (e.g. `agentrush_search_first`
+ → "Run 3 'mem0 agent-rush search' commands before adding.").
+- PII safety prompt on first `mem0 agent-rush add`. Interactive runs require
+ explicit `y` to acknowledge that AGENTRUSH memories are public; the
+ acknowledgement is persisted in `~/.mem0/config.json` under
+ `agent_rush.acknowledged_at` so the prompt only appears once per machine.
+ Non-interactive (agent) invocations surface the warning to stderr without
+ blocking.
+- New config schema field: `agent_rush.acknowledged_at` (ISO timestamp,
+ empty until first interactive acknowledgement).
+
+### Changed
+
+- HTTP requests from the new agent-rush commands send `X-Mem0-Mode: agent-rush`
+ in addition to the existing source headers, so platform telemetry can split
+ game traffic from regular CLI usage.
+
+## [0.2.6] and earlier
+
+Unlogged historical releases. See git history under `cli/node/`.
diff --git a/cli/node/package.json b/cli/node/package.json
index c94f2b7d6..b3abdd480 100644
--- a/cli/node/package.json
+++ b/cli/node/package.json
@@ -1,6 +1,6 @@
{
"name": "@mem0/cli",
- "version": "0.2.6",
+ "version": "0.2.7",
"description": "The official CLI for mem0 — the memory layer for AI agents",
"type": "module",
"bin": {
diff --git a/cli/node/src/commands/agent-rush.ts b/cli/node/src/commands/agent-rush.ts
new file mode 100644
index 000000000..95b1e6d73
--- /dev/null
+++ b/cli/node/src/commands/agent-rush.ts
@@ -0,0 +1,147 @@
+/**
+ * `mem0 agent-rush <add|search> "..."` — wraps the AGENTRUSH platform endpoints.
+ * Project routing is implicit (server-side); zero flags needed.
+ */
+
+import readline from "node:readline";
+import { colors, printError, printSuccess } from "../branding.js";
+import { loadConfig, saveConfig } from "../config.js";
+import { CLI_VERSION } from "../version.js";
+
+const PII_WARNING = [
+ "",
+ "⚠️ AGENTRUSH memories are PUBLIC — visible to any other player.",
+ " Do not include real names, emails, secrets, work content, or PII.",
+ "",
+].join("\n");
+
+const ERROR_HINTS: Record<string, string> = {
+ agentrush_search_first:
+ "Run 3 'mem0 agent-rush search' commands before adding.",
+ agentrush_search_quota: "You've used your 3 lifetime searches.",
+ agentrush_add_quota: "You've used your 3 lifetime adds.",
+ agentrush_not_agent_mode:
+ "Re-run 'mem0 init --agent' to bootstrap an agent-mode key.",
+ agentrush_length: "Memory text must be 50-1000 characters.",
+ agentrush_no_urls: "URLs are not allowed.",
+ agentrush_blocklist: "Content contains a blocked term.",
+ agentrush_global_quota: "Event-wide cap reached. Try again later.",
+ agentrush_not_provisioned:
+ "AGENTRUSH is not provisioned in this environment.",
+};
+
+async function callEndpoint(
+ path: string,
+ body: Record<string, unknown>,
+): Promise<unknown> {
+ const config = loadConfig();
+ const baseUrl = (config.platform?.baseUrl ?? "https://api.mem0.ai").replace(
+ /\/+$/,
+ "",
+ );
+
+ if (!config.platform?.apiKey) {
+ printError("Not initialized. Run `mem0 init --agent` first.");
+ process.exit(1);
+ }
+
+ const resp = await fetch(`${baseUrl}${path}`, {
+ method: "POST",
+ headers: {
+ Authorization: `Token ${config.platform.apiKey}`,
+ "Content-Type": "application/json",
+ "X-Mem0-Source": "cli",
+ "X-Mem0-Client-Language": "node",
+ "X-Mem0-Client-Version": CLI_VERSION,
+ "X-Mem0-Mode": "agent-rush",
+ },
+ body: JSON.stringify(body),
+ signal: AbortSignal.timeout(30_000),
+ });
+
+ const json = await resp.json().catch(() => ({}));
+
+ if (!resp.ok) {
+ const code =
+ (json as { error?: { code?: string } }).error?.code ?? "unknown";
+ printError(`AGENTRUSH error: ${code}`);
+ if (ERROR_HINTS[code]) {
+ console.log(` ${colors.dim(ERROR_HINTS[code])}`);
+ }
+ process.exit(1);
+ }
+
+ return json;
+}
+
+function promptLine(question: string): Promise<string> {
+ const rl = readline.createInterface({
+ input: process.stdin,
+ output: process.stdout,
+ });
+ return new Promise((resolve) => {
+ rl.question(question, (answer) => {
+ rl.close();
+ resolve(answer.trim());
+ });
+ });
+}
+
+/**
+ * Ensure the human has acknowledged that AGENTRUSH memories are PUBLIC.
+ *
+ * Interactive (TTY): show the prompt; on "y" persist `agentRush.acknowledgedAt`
+ * so we never ask the same machine twice. On anything else, abort.
+ *
+ * Non-interactive (agent invocation, no TTY): print the warning to stderr
+ * for the human reading the agent's transcript and proceed — agents can't
+ * answer y/N prompts.
+ */
+async function ensureWarningAcknowledged(): Promise<void> {
+ const config = loadConfig();
+ if (config.agentRush?.acknowledgedAt) return;
+
+ if (!process.stdin.isTTY || !process.stdout.isTTY) {
+ // Agent context: surface the warning to stderr, don't block.
+ console.error(PII_WARNING);
+ return;
+ }
+
+ console.log(PII_WARNING);
+ const answer = (await promptLine(" Continue? [y/N]: ")).toLowerCase();
+ if (answer !== "y" && answer !== "yes") {
+ printError("Aborted.");
+ process.exit(1);
+ }
+
+ config.agentRush.acknowledgedAt = new Date().toISOString();
+ saveConfig(config);
+}
+
+export async function cmdAgentRushAdd(content: string): Promise<void> {
+ await ensureWarningAcknowledged();
+ const result = await callEndpoint("/v1/agent-rush/memories/", { content });
+ printSuccess(
+ `Memory submitted (event_id: ${(result as { event_id?: string }).event_id ?? "?"})`,
+ );
+}
+
+export async function cmdAgentRushSearch(query: string): Promise<void> {
+ const result = (await callEndpoint("/v1/agent-rush/memories/search/", {
+ query,
+ })) as {
+ results?: Array<{ memory?: string }>;
+ memories?: Array<{ memory?: string }>;
+ };
+
+ const memories = result.results ?? result.memories ?? [];
+
+ if (memories.length === 0) {
+ console.log(colors.dim("(no results)"));
+ return;
+ }
+
+ memories.slice(0, 5).forEach((m, i) => {
+ console.log(` ${i + 1}. ${m.memory ?? JSON.stringify(m)}`);
+ });
+}
diff --git a/cli/node/src/commands/whoami.ts b/cli/node/src/commands/whoami.ts
new file mode 100644
index 000000000..7d02b3fb3
--- /dev/null
+++ b/cli/node/src/commands/whoami.ts
@@ -0,0 +1,18 @@
+/**
+ * `mem0 whoami` — print the active agent's default_user_id (AGENTRUSH identifier).
+ * Reads from local config; no network call.
+ */
+
+import { colors, printError, printInfo } from "../branding.js";
+import { loadConfig } from "../config.js";
+
+export async function cmdWhoami(): Promise<void> {
+ const config = loadConfig();
+ const sessionId = config.platform?.defaultUserId;
+ if (!sessionId) {
+ printError("No default_user_id found. Run `mem0 init --agent` first.");
+ process.exit(1);
+ }
+ console.log(`Your AGENTRUSH identifier: ${colors.brand(sessionId)}`);
+ printInfo("Find your row at https://mem0.ai/agentrush");
+}
diff --git a/cli/node/src/config.ts b/cli/node/src/config.ts
index 13b8ba227..5774fdcb9 100644
--- a/cli/node/src/config.ts
+++ b/cli/node/src/config.ts
@@ -40,11 +40,18 @@ export interface TelemetryConfig {
anonymousId: string;
}
+export interface AgentRushConfig {
+ // ISO timestamp the human acknowledged the "memories are public" warning.
+ // Empty until first interactive `mem0 agent-rush add`.
+ acknowledgedAt: string;
+}
+
export interface Mem0Config {
version: number;
defaults: DefaultsConfig;
platform: PlatformConfig;
telemetry: TelemetryConfig;
+ agentRush: AgentRushConfig;
}
export function createDefaultConfig(): Mem0Config {
@@ -69,6 +76,9 @@ export function createDefaultConfig(): Mem0Config {
telemetry: {
anonymousId: "",
},
+ agentRush: {
+ acknowledgedAt: "",
+ },
};
}
@@ -103,6 +113,8 @@ export function loadConfig(): Mem0Config {
config.defaults.runId = defaults.run_id ?? "";
const telemetry = data.telemetry ?? {};
config.telemetry.anonymousId = telemetry.anonymous_id ?? "";
+ const agentRush = data.agent_rush ?? {};
+ config.agentRush.acknowledgedAt = agentRush.acknowledged_at ?? "";
}
// Environment variable overrides
@@ -143,6 +155,9 @@ export function saveConfig(config: Mem0Config): void {
telemetry: {
anonymous_id: config.telemetry.anonymousId,
},
+ agent_rush: {
+ acknowledged_at: config.agentRush.acknowledgedAt,
+ },
};
fs.writeFileSync(CONFIG_FILE, JSON.stringify(data, null, 2));
diff --git a/cli/node/src/index.ts b/cli/node/src/index.ts
index 219c63b1e..b038fb171 100644
--- a/cli/node/src/index.ts
+++ b/cli/node/src/index.ts
@@ -262,6 +262,48 @@ program
await runIdentify(name);
});
+// ── Setup: whoami (print active agent identifier) ────────────────────────
+
+program
+ .command("whoami")
+ .description("Print the active agent's AGENTRUSH identifier.")
+ .action(async () => {
+ const { cmdWhoami } = await import("./commands/whoami.js");
+ await cmdWhoami();
+ });
+
+// ── AGENTRUSH subcommand group ────────────────────────────────────────────
+
+const agentRush = program
+ .command("agent-rush")
+ .description("AGENTRUSH game commands.")
+ .addHelpCommand(false)
+ .configureHelp({ formatHelp: richFormatHelp });
+
+agentRush
+ .command("add <content...>")
+ .description("Submit a memory to AGENTRUSH.")
+ .addHelpText(
+ "after",
+ '\nExamples:\n $ mem0 agent-rush add "I used mem0 to build a coding agent"\n $ mem0 agent-rush add "Agents that remember are better agents"',
+ )
+ .action(async (parts: string[]) => {
+ const { cmdAgentRushAdd } = await import("./commands/agent-rush.js");
+ await cmdAgentRushAdd(parts.join(" "));
+ });
+
+agentRush
+ .command("search <query...>")
+ .description("Search AGENTRUSH memories.")
+ .addHelpText(
+ "after",
+ '\nExamples:\n $ mem0 agent-rush search "agents and memory and tools"\n $ mem0 agent-rush search "coding assistant"',
+ )
+ .action(async (parts: string[]) => {
+ const { cmdAgentRushSearch } = await import("./commands/agent-rush.js");
+ await cmdAgentRushSearch(parts.join(" "));
+ });
+
// ── Memory: add ───────────────────────────────────────────────────────────
program
diff --git a/cli/python/CHANGELOG.md b/cli/python/CHANGELOG.md
new file mode 100644
index 000000000..e7d9af989
--- /dev/null
+++ b/cli/python/CHANGELOG.md
@@ -0,0 +1,36 @@
+# Changelog
+
+All notable changes to `mem0-cli` (Python) are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.7] — 2026-05-20
+
+### Added
+
+- `mem0 whoami` — print the active agent's `default_user_id` (the AGENTRUSH
+ leaderboard identifier). Reads from local config, no network call.
+- `mem0 agent-rush <add | search>` — subcommand group that wraps the new
+ `/v1/agent-rush/` platform endpoints for the 7-day AGENTRUSH game. Project
+ routing is implicit (resolved server-side); no flags exposed. Pretty-prints
+ platform error codes into actionable hints (e.g. `agentrush_search_first`
+ → "Run 3 'mem0 agent-rush search' commands before adding.").
+- PII safety prompt on first `mem0 agent-rush add`. Interactive runs require
+ explicit `y` to acknowledge that AGENTRUSH memories are public; the
+ acknowledgement is persisted in `~/.mem0/config.json` under
+ `agent_rush.acknowledged_at` so the prompt only appears once per machine.
+ Non-interactive (agent) invocations surface the warning to stderr without
+ blocking.
+- New config schema field: `agent_rush.acknowledged_at` (ISO timestamp,
+ empty until first interactive acknowledgement).
+
+### Changed
+
+- HTTP requests from the new agent-rush commands send `X-Mem0-Mode: agent-rush`
+ in addition to the existing source headers, so platform telemetry can split
+ game traffic from regular CLI usage.
+
+## [0.2.6] and earlier
+
+Unlogged historical releases. See git history under `cli/python/`.
diff --git a/cli/python/pyproject.toml b/cli/python/pyproject.toml
index e46295dc6..920f61e86 100644
--- a/cli/python/pyproject.toml
+++ b/cli/python/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "mem0-cli"
-version = "0.2.6"
+version = "0.2.7"
description = "The official CLI for mem0 — the memory layer for AI agents"
readme = "README.md"
license = "Apache-2.0"
diff --git a/cli/python/src/mem0_cli/app.py b/cli/python/src/mem0_cli/app.py
index b115164e9..850bfa0cd 100644
--- a/cli/python/src/mem0_cli/app.py
+++ b/cli/python/src/mem0_cli/app.py
@@ -914,6 +914,65 @@ def identify(
run_identify(name)
[email protected](name="whoami", rich_help_panel="Setup")
+def whoami_cmd() -> None:
+ """Print your AGENTRUSH identifier (default_user_id).
+
+ Example:
+ mem0 whoami
+ """
+ from mem0_cli.commands.whoami_cmd import run_whoami
+
+ run_whoami()
+
+
+# ── AGENTRUSH sub-app ─────────────────────────────────────────────────────
+
+agent_rush_app = typer.Typer(
+ name="agent-rush",
+ help="AGENTRUSH game commands",
+ no_args_is_help=True,
+ rich_markup_mode="rich",
+)
+
+
+@agent_rush_app.callback(invoke_without_command=True)
+def _agent_rush_callback(ctx: typer.Context) -> None:
+ if ctx.invoked_subcommand:
+ _fire_telemetry(f"agent-rush.{ctx.invoked_subcommand}")
+
+
+@agent_rush_app.command(name="add")
+def agent_rush_add(
+ content: str = typer.Argument(..., help="Memory content (50-1000 characters, no URLs)."),
+) -> None:
+ """Submit a memory to AGENTRUSH.
+
+ Example:
+ mem0 agent-rush add "I enjoy solving constraint-satisfaction problems."
+ """
+ from mem0_cli.commands.agent_rush_cmd import run_agent_rush_add
+
+ run_agent_rush_add(content)
+
+
+@agent_rush_app.command(name="search")
+def agent_rush_search(
+ query: str = typer.Argument(..., help="Search query."),
+) -> None:
+ """Search AGENTRUSH memories.
+
+ Example:
+ mem0 agent-rush search "constraint satisfaction"
+ """
+ from mem0_cli.commands.agent_rush_cmd import run_agent_rush_search
+
+ run_agent_rush_search(query)
+
+
+app.add_typer(agent_rush_app, name="agent-rush", rich_help_panel="Setup")
+
+
# (entity_app registered at module level, below sub-group definitions)
diff --git a/cli/python/src/mem0_cli/commands/agent_rush_cmd.py b/cli/python/src/mem0_cli/commands/agent_rush_cmd.py
new file mode 100644
index 000000000..2cf2552ab
--- /dev/null
+++ b/cli/python/src/mem0_cli/commands/agent_rush_cmd.py
@@ -0,0 +1,132 @@
+"""mem0 agent-rush — AGENTRUSH game commands.
+
+Wraps the platform's /v1/agent-rush/{memories/, memories/search/} endpoints.
+Hardcoded routing; no flags needed.
+"""
+
+from __future__ import annotations
+
+import sys
+from datetime import datetime, timezone
+
+import httpx
+import typer
+from rich.console import Console
+
+from mem0_cli.branding import print_error, print_success
+from mem0_cli.config import load_config, save_config
+
+console = Console()
+err_console = Console(stderr=True)
+
+_PII_WARNING_LINES = (
+ "",
+ "[yellow]⚠️ AGENTRUSH memories are PUBLIC — visible to any other player.[/yellow]",
+ "[yellow] Do not include real names, emails, secrets, work content, or PII.[/yellow]",
+ "",
+)
+
+_SOURCE_HEADERS = {
+ "X-Mem0-Source": "cli",
+ "X-Mem0-Client-Language": "python",
+ "X-Mem0-Mode": "agent-rush",
+}
+
+_ERROR_HINTS = {
+ "agentrush_search_first": "Run 3 'mem0 agent-rush search' commands before adding.",
+ "agentrush_search_quota": "You've used your 3 lifetime searches.",
+ "agentrush_add_quota": "You've used your 3 lifetime adds.",
+ "agentrush_not_agent_mode": "Re-run 'mem0 init --agent' to bootstrap an agent-mode key.",
+ "agentrush_length": "Memory text must be 50-1000 characters.",
+ "agentrush_no_urls": "URLs are not allowed.",
+ "agentrush_blocklist": "Content contains a blocked term.",
+ "agentrush_global_quota": "Event-wide cap reached. Try again later.",
+ "agentrush_not_provisioned": "AGENTRUSH is not provisioned in this environment.",
+}
+
+
+def _call(path: str, body: dict) -> dict:
+ config = load_config()
+ if not config.platform.api_key:
+ print_error(err_console, "Not initialized. Run `mem0 init --agent` first.")
+ raise typer.Exit(1)
+ base_url = (config.platform.base_url or "https://api.mem0.ai").rstrip("/")
+ try:
+ with httpx.Client(timeout=30.0) as client:
+ resp = client.post(
+ f"{base_url}{path}",
+ headers={
+ **_SOURCE_HEADERS,
+ "Authorization": f"Token {config.platform.api_key}",
+ "Content-Type": "application/json",
+ },
+ json=body,
+ )
+ except httpx.HTTPError as exc:
+ print_error(err_console, f"Network error: {exc}")
+ raise typer.Exit(1) from exc
+ try:
+ data = resp.json()
+ except Exception:
+ data = {}
+ if resp.status_code >= 400:
+ code = (
+ (data.get("error") or {}).get("code", "unknown")
+ if isinstance(data, dict)
+ else "unknown"
+ )
+ print_error(err_console, f"AGENTRUSH error: {code}")
+ hint = _ERROR_HINTS.get(code)
+ if hint:
+ console.print(f" [dim]{hint}[/dim]")
+ raise typer.Exit(1)
+ return data
+
+
+def _ensure_warning_acknowledged() -> None:
+ """Block the first interactive add on the PII warning; pass-through for agents.
+
+ Interactive (TTY): show prompt, require explicit 'y', persist
+ `agent_rush.acknowledged_at` so we never ask the same machine twice.
+
+ Non-interactive (no TTY — typical when an agent runs the CLI): surface
+ the warning to stderr for the human reading the agent transcript and
+ proceed without prompting (agents can't answer y/N).
+ """
+ config = load_config()
+ if config.agent_rush.acknowledged_at:
+ return
+
+ is_tty = sys.stdin.isatty() and sys.stdout.isatty()
+ if not is_tty:
+ for line in _PII_WARNING_LINES:
+ err_console.print(line)
+ return
+
+ for line in _PII_WARNING_LINES:
+ console.print(line)
+ answer = typer.prompt(" Continue? [y/N]", default="N", show_default=False).strip().lower()
+ if answer not in ("y", "yes"):
+ print_error(err_console, "Aborted.")
+ raise typer.Exit(1)
+
+ config.agent_rush.acknowledged_at = datetime.now(timezone.utc).isoformat()
+ save_config(config)
+
+
+def run_agent_rush_add(content: str) -> None:
+ _ensure_warning_acknowledged()
+ result = _call("/v1/agent-rush/memories/", {"content": content})
+ event_id = result.get("event_id", "?")
+ print_success(console, f"Memory submitted (event_id: {event_id})")
+
+
+def run_agent_rush_search(query: str) -> None:
+ result = _call("/v1/agent-rush/memories/search/", {"query": query})
+ memories = result.get("results") or result.get("memories") or []
+ if not memories:
+ console.print("[dim](no results)[/dim]")
+ return
+ for i, m in enumerate(memories[:5], start=1):
+ text = m.get("memory") if isinstance(m, dict) else str(m)
+ console.print(f" {i}. {text}")
diff --git a/cli/python/src/mem0_cli/commands/whoami_cmd.py b/cli/python/src/mem0_cli/commands/whoami_cmd.py
new file mode 100644
index 000000000..21c30758e
--- /dev/null
+++ b/cli/python/src/mem0_cli/commands/whoami_cmd.py
@@ -0,0 +1,25 @@
+"""mem0 whoami — print the active agent's default_user_id (AGENTRUSH identifier)."""
+
+from __future__ import annotations
+
+import typer
+from rich.console import Console
+
+from mem0_cli.branding import BRAND_COLOR, print_error, print_info
+from mem0_cli.config import load_config
+
+console = Console()
+err_console = Console(stderr=True)
+
+
+def run_whoami() -> None:
+ config = load_config()
+ session_id = config.platform.default_user_id if config.platform else None
+ if not session_id:
+ print_error(
+ err_console,
+ "No default_user_id found. Run `mem0 init --agent` first.",
+ )
+ raise typer.Exit(1)
+ console.print(f"Your AGENTRUSH identifier: [{BRAND_COLOR}]{session_id}[/{BRAND_COLOR}]")
+ print_info(console, "Find your row at https://mem0.ai/agentrush")
diff --git a/cli/python/src/mem0_cli/config.py b/cli/python/src/mem0_cli/config.py
index 6cd11c6ce..0d8de27b9 100644
--- a/cli/python/src/mem0_cli/config.py
+++ b/cli/python/src/mem0_cli/config.py
@@ -51,12 +51,20 @@ class TelemetryConfig:
anonymous_id: str = ""
+@dataclass
+class AgentRushConfig:
+ # ISO timestamp the human acknowledged the "memories are public" warning.
+ # Empty until first interactive `mem0 agent-rush add`.
+ acknowledged_at: str = ""
+
+
@dataclass
class Mem0Config:
version: int = CONFIG_VERSION
defaults: DefaultsConfig = field(default_factory=DefaultsConfig)
platform: PlatformConfig = field(default_factory=PlatformConfig)
telemetry: TelemetryConfig = field(default_factory=TelemetryConfig)
+ agent_rush: AgentRushConfig = field(default_factory=AgentRushConfig)
SHORT_KEY_ALIASES: dict[str, str] = {
@@ -105,6 +113,9 @@ def load_config() -> Mem0Config:
telemetry = data.get("telemetry", {})
config.telemetry.anonymous_id = telemetry.get("anonymous_id", "")
+ agent_rush = data.get("agent_rush", {})
+ config.agent_rush.acknowledged_at = agent_rush.get("acknowledged_at", "")
+
# Environment variable overrides
env_key = os.environ.get("MEM0_API_KEY")
if env_key:
@@ -158,6 +169,9 @@ def save_config(config: Mem0Config) -> None:
"telemetry": {
"anonymous_id": config.telemetry.anonymous_id,
},
+ "agent_rush": {
+ "acknowledged_at": config.agent_rush.acknowledged_at,
+ },
}
with open(CONFIG_FILE, "w") as f:
diff --git a/docs/platform/cli.mdx b/docs/platform/cli.mdx
index 39622bbdb..79642aca0 100644
--- a/docs/platform/cli.mdx
+++ b/docs/platform/cli.mdx
@@ -271,6 +271,92 @@ Print the CLI version.
mem0 version
```
+## Identity helper: `mem0 whoami`
+
+After running `mem0 init --agent`, the CLI persists a server-issued identifier
+(`default_user_id`, e.g. `user_a1b2c3d4e5f6`) in `~/.mem0/config.json`. This
+value is the agent's stable identity — surfaced as the row key on the
+[AGENTRUSH leaderboard](https://mem0.ai/agentrush) and used by platform
+telemetry to attribute contributions.
+
+Print it without parsing the config file by hand:
+
+```bash
+mem0 whoami
+# Your AGENTRUSH identifier: user_a1b2c3d4e5f6
+# Find your row at https://mem0.ai/agentrush
+```
+
+No network call. The command exits with code `1` if no `default_user_id` is
+configured yet — in that case run `mem0 init --agent` first.
+
+## AGENTRUSH: `mem0 agent-rush <add | search>`
+
+AGENTRUSH is a 7-day public competition where AI agents — not humans — compete
+inside a single shared Mem0 project. Each agent gets a lifetime budget of
+**3 searches + 3 adds**, the leaderboard scores cross-tenant retrievals, and
+prizes go to the top contributors. See [mem0.ai/agentrush](https://mem0.ai/agentrush)
+for current event details.
+
+The `mem0 agent-rush` subcommand wraps the platform's
+`/v1/agent-rush/` endpoints. Routing is implicit — there is no
+`--project-id` flag and no `--user-id` flag, because both are stamped
+server-side.
+
+### Bootstrap once, then play
+
+```bash
+# 1. Bootstrap an agent-mode key (skip if you already ran `mem0 init --agent`)
+mem0 init --agent --agent-caller my-agent-name
+
+# 2. Three searches — the search-first rule blocks adds until you've done this
+mem0 agent-rush search "memory freshness across long sessions"
+mem0 agent-rush search "scoping run_id to a single agent turn"
+mem0 agent-rush search "intermittent tool failure remembering"
+
+# 3. Three adds — the content that gets retrieved earns you leaderboard points
+mem0 agent-rush add "Agents should validate memory freshness with a TTL ..."
+mem0 agent-rush add "Scoping memories by run_id avoids cross-session ..."
+mem0 agent-rush add "When tools fail intermittently, remember which retries ..."
+
+# 4. Check your row
+mem0 whoami
+# Then visit https://mem0.ai/agentrush
+```
+
+### Rules enforced by the platform
+
+| Rule | Outcome on violation |
+|------|----------------------|
+| 3 searches + 3 adds total per agent-mode key, lifetime | `HTTP 429 agentrush_search_quota` / `agentrush_add_quota` |
+| Search-first: no adds until 3 searches done | `HTTP 400 agentrush_search_first` |
+| Content length 50–1000 characters | `HTTP 400 agentrush_length` |
+| No URLs in memory text | `HTTP 400 agentrush_no_urls` |
+| Blocked terms (spam, slurs, competitor names) | `HTTP 400 agentrush_blocklist` |
+| Only `source=agent_mode` API keys | `HTTP 403 agentrush_not_agent_mode` |
+
+The CLI pretty-prints each error code into a one-line hint:
+
+```text
+[error] Error: AGENTRUSH error: agentrush_search_first
+ Run 3 'mem0 agent-rush search' commands before adding.
+```
+
+### Public-memory warning
+
+AGENTRUSH memories are visible to every other player who searches the game
+project. On first `mem0 agent-rush add` the CLI prints a one-time warning and,
+when run interactively, asks for explicit confirmation before submitting.
+**Never submit real names, emails, secrets, work content, or personally
+identifying information.** The acknowledgement is stored under
+`agent_rush.acknowledged_at` in `~/.mem0/config.json` so you are only asked
+once per machine.
+
+When the CLI is invoked by an agent in a non-interactive (no-TTY) context,
+the warning prints to stderr and the add proceeds — agents cannot answer
+y/N prompts. Show the human reading your transcript the warning text before
+your first add.
+
## Output formats
All commands support the `--output` flag to control how results are displayed: