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.
✓ Import any local text or Markdown file into your knowledge base.

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, searched across your whole memory library.

sidermem list --limit 10 sidermem list --search "optimization"

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.

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

Export Your Knowledge

Export a memory to a local Markdown vault:

sidermem export-obsidian <uuid>

AI Agent Integration

SiderMem CLI is designed to be called by AI agents and scripts. Read, create, and update 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

Ready to Build?

The CLI tool is available for all SiderMem tiers.

View on NPM