CLI Overview

Metateam is a persistent memory system for AI coding agents, packaged as a single binary. Every feature is a subcommand. Most commands are invoked by agents automatically; users primarily interact via metateam setup (one-time setup), metateam account login (re-authentication), metateam session ..., and the web dashboard at metateam.ai.

metateam v1.0.1 - AI persistent memory https://metateam.ai

Global Options

Every subcommand accepts these flags:

Flag	Purpose
`--api-url <URL>`	Override the API endpoint
`--api-key <KEY>`	Override the API key
`--debug`	Enable debug logging
`-q, --quiet`	Suppress non-essential output
`-j, --json`	Output as JSON
`--color <MODE>`	Color output: `auto`, `always`, `never`

Command Groups

Group	What it does
Sessions	Search, load, inspect, delete, upload sessions
Knowledge Base	Read, write, search, version KB entries
Projects	Create, list, rename, delete KB projects; pin directories
Hook & Setup	Install hooks, first-time setup, check status
Monitor & Start	Background session capture for Codex (and Gemini fallback)
Crew	Multi-agent orchestration
Attractor	Pipeline engine (DOT-based workflows)
Repo	Local FTS5 code search
Account	Setup, auth, API keys, settings, activity logs
Memory	Semantic memory stats, list, recall, remember, show, forget
Update	Self-update checks and installs

Sessions Quick Start

Search sessions:

$ metateam session search "auth bug"

Load a session by ID/prefix (8+ hex chars):

$ metateam session show 82bbfb7c

Load the most recent session:

$ metateam session last
$ metateam session last --full -s 2000

Date Filtering (`--when`)

The --when flag works on metateam session search. It accepts:

Format	Example	Meaning
Shortcuts	`today`, `yesterday`	Calendar days
Relative	`7d`, `2w`, `1m`, `1y`	Days, weeks, months, years ago
Exact date	`2024-01-15`	That specific day
Range	`2024-01-01..2024-01-31`	Between two dates
Open range	`2024-01-01..`	From that date onward
Open range	`..2024-12-31`	Up to that date

Output Limits