@substratia/cli

Persistent memory for AI agents - command line interface.

Installation

# Quick install (recommended)
curl -fsSL https://substratia.io/install | bash

# Or via npm/bun
npm install -g @substratia/cli
bun install -g @substratia/cli

Quick Start

# 1. Register and get your API key
substratia register "[email protected]"

# 2. Store a memory
substratia learn "User prefers dark mode"

# 3. Search memories
substratia remember "preferences"

# 4. Full context restore
substratia bridge

Commands

register <email>

Register for an API key.

substratia register "[email protected]"

learn <content>

Store a new memory.

substratia learn "Important information"
substratia learn "Critical fact" --importance critical
substratia learn "Tagged memory" --tags "tag1,tag2"

Options:

• --importance: critical, high, normal, low (default: normal)
• --tags: Comma-separated tags

remember <query>

Search your memories.

substratia remember "user preferences"
substratia remember "project" --limit 5

Options:

• --limit: Maximum results to return (default: 10)

bridge

Full context restore - retrieves memories, identity narratives, and preferences.

substratia bridge

config

Show current configuration.

substratia config

Environment Variables

• SUBSTRATIA_API_KEY - Your API key (overrides config file)

Configuration

Config is stored in ~/.substratia/config.json

For Programmatic Use

Use @substratia/memory instead:

import { remember, recall } from "@substratia/memory";

await remember("User prefers dark mode");
const memories = await recall("preferences");

Documentation

https://substratia.io/docs

License

MIT