@memofs/cli

@memofs/cli

         

MemoFS command-line interface for local and hybrid memory workflows.

What is this?

The @memofs/cli package gives you a command-line tool (memofs) for managing local and hybrid memory. You can use it to initialize a memory workspace, store durable decisions, search past memory, sync with MemoFS Cloud, and manage agent sessions and connectors.

Installation

npm install -D @memofs/cli

Requires Node.js >= 22.

Or use directly without installing:

npx memofs --help

Quick Start

Initialize memory in your project and store a durable decision:

# Initialize a memory workspace in the current directory
npx memofs init

# Store a durable decision
npx memofs remember "Use VoyageAI for embeddings" --kind decision

# Get context for a task
npx memofs context --query "current task" --json

# Inspect the current memory state
npx memofs inspect

# Backfill code anchors onto existing notes (drift detection)
npx memofs migrate anchors

# Archive deprecated memories to cold storage
npx memofs consolidate --archive-deprecated

# Restore an archived memory
npx memofs restore <id>

Configuration and Usage

The CLI supports Local (default) and Hybrid runtime modes.

You can configure defaults using a .memofs/config.json file. For a complete list of commands, global flags, and cloud integration features, refer to the Full Documentation.

Contributing

See our central Contributing Guide and development scripts for details on formatting, linting, and testing within the monorepo.

License

MIT