Terminal · cogs

Your Minds. At your command.

Search an agent’s memory, save a backup, or switch between Minds without leaving your terminal. cogs is the Minds command-line tool for everyday operations and repeatable scripts.

Command line

Your Mind. From the terminal.

studio — zshcogs

cogs instances use studio

Active instance: studio

cogs memory search "release plan"

RECALLED CONTEXT · EXAMPLE

Weekly releases.

The team chose weekly releases after the launch review.

episodicrelease-plan

Keep the result with its context.

Use the returned record in your next step. The sample record keeps the decision and its context together.

Choose a chapter to explore

Example terminal session with a sample connection and stored decision.

Commands

Keep everyday work in your workflow.

Use a command for a quick task, combine commands in a script, or open the interactive control room when you want to explore.

01

Cloud

Connect where your Mind runs.

Manage hosted Minds or connect to a local Akasha instance. Keep the same terminal workflow as you move from development to deployment.

02

Instances

Switch without leaving the shell.

Save named connections for your Minds and choose the one you need. Move between a development instance and production with `cogs instances use`.

03

Backup

Keep a recovery point.

Create a backup before a significant change. Keep it on disk, in S3, or on a remote filesystem, then restore from its backup ID when needed.

04

Volumes

Manage attached storage.

List, create, and attach S3 or filesystem volumes from the command line. Give each volume a clear purpose, such as data or backups.

05

Recall

Find the context behind a decision.

Look up a customer note or ask what changed in a project. Search stored memories directly, without opening your application.

06

Inspection

See what your Mind can do.

Open control-room to inspect your connection, graph, memory, and configured models. Keep the selected instance visible as you move between views.

Shell

Connect. Search. Save a backup.

cogsbash
$ cogs login
$ cogs instances add
# Choose the saved instance named prod
$ cogs instances use prod
$ cogs memory search "Q3 revenue"
$ cogs memory retrieval-hybrid "Why did Q3 revenue dip?" --limit 5

# Backup to disk, or ship it to S3
$ cogs storage create-backup ./backups --remote-s3-bucket minds-backups --remote-s3-prefix prod
$ cogs storage list-backups ./backups
$ cogs storage restore-backup ./backups <backup-id>

# Open the interactive terminal interface
$ cogs control-room
Reference

The commands to keep close.

At a glance
Command
cogs
Switch
instances use · control-room Ctrl+1-9
Backup targets
local · S3 · remote filesystem
Volume kinds
S3 · filesystem
Connect
cogs login · cogs instances add

Put your Mind on the command line.

Install cogs, connect an instance, and run your first memory search.