SiderMem CLI

The professional bridge between your local development environment and your AI memory vault.

Why use the CLI?

While the Chrome extension is perfect for capturing chatbot conversations, the CLI tool extends SiderMem's power to your actual coding workspace.

✓ Upload log files or error traces instantly for AI analysis.
✓ Pipe shell command outputs directly into your memory vault.
✓ Access and search your AI context without switching windows.
✓ Capture Claude Code, Codex, and Gemini/Antigravity memory files into cloud memory.

sidermem list --search "performance"

1. Quick Installation

SiderMem CLI is built on Node.js and distributed globally via NPM. Run this command in your terminal:

npm install -g sidermem-cli

Requires Node.js 18.0 or higher. You may need 'sudo' depending on your system configuration.

2. Authentication

Sync your terminal session with your SiderMem account in seconds using passwordless authentication.

Step A

Initial Login

sidermem login

Enter your registered email. A 6-digit OTP will be sent to your inbox. Once verified, your encrypted session is stored in your local system config.

Step B

Monitor Quota

sidermem status

Instantly view your current Plan Tier, cloud storage usage, and active quota limits.

3. Command Reference

Browse & Search

Find your knowledge anchors without browser context switching. Use namespace filters to narrow results to one agent or project.

sidermem list --limit 10 sidermem list --search "optimization" sidermem list --namespace "/Users/me/workspace/app"

Read Content

Access the full text or metadata for any memory by full UUID or an unambiguous UUID prefix.

sidermem show 5f2a

Prints the complete memory body to stdout.

sidermem info 5f2a --json

Shows title, type, size, last-updated timestamp, and AI summary when available.

Capture from Workspace

Inject local context into your AI vault effortlessly.

Scenario 1: Upload a File

sidermem create --file ./documentation.md

Perfect for long-form content or project specifications. The filename becomes the memory title.

Scenario 2: Pipe from Shell

git diff main | sidermem create -t "Feature Diff"

Pipe any shell output directly into a new memory. Works with logs, diffs, command output, and more.

Scenario 3: Inline Content

sidermem create -t "My Note" -c "content here"

Write a quick note or paste a snippet directly on the command line.

Capture Agent Memories

Import local memory files from AI coding tools. Each capture command shows an insert/update/noop plan before writing.

sidermem capture-claude -t memory

Scans Claude Code projects under ~/.claude/projects, lets you pick one, and excludes the internal MEMORY.md index.

sidermem capture-codex -t memory

Recursively captures Codex memories from ~/.codex/memories into the codexglobal namespace.

sidermem capture-gemini -t memory

Captures Gemini/Antigravity global memories or project skills. Alias: capture-agy.

sidermem capture-claude -t memory --dry-run sidermem capture-codex -t memory --yes sidermem capture-gemini -t memory --json

Capture namespaces use readable partitions such as codexglobal, agyglobal, or the full absolute project path, so different agents can share the same project memory partition.

Edit & Remove

Keep your vault accurate — update stale notes or clean up what you no longer need.

sidermem update 5f2a --title "New Title" sidermem update 5f2a --content "Revised content"

sidermem delete 5f2a sidermem delete 5f2a --yes

Session Management

Your session is stored locally and auto-refreshes. Log out when you're done on a shared machine.

sidermem logout

⚡️ Developer Workflows

Git Context Preservation

Archive your recent commit history before switching branches:

git log -n 5 --oneline | sidermem create -t "Branch Sync Context"

Capture a Code Diff

Save your latest changes for AI review or team sharing:

git diff main | sidermem create -t "Feature Implementation Diff"

Collaborative Debugging

Caught an elusive runtime error? Save the stack trace instantly:

sidermem create --file ./error-trace.log

Agent Memory Sync

Preview Codex memory changes before syncing them to your cloud vault:

sidermem capture-codex -t memory --dry-run

AI Agent Integration

SiderMem CLI is designed to be called by AI agents — Claude Code, Codex, Gemini CLI, Antigravity, and others. Read, create, and capture commands support --json for clean stdout output.

Step 1 — Discover available memories

sidermem list --json

Step 2 — Fetch relevant content

sidermem show <uuid> --json

Step 3 — Save new context

sidermem create -t "title" -c "content" --json

Step 4 — Capture local agent memories

sidermem capture-gemini -t memory --json

Ready to Build?

The CLI tool is available for all SiderMem tiers.

View on NPM