Monitor & Start

metateam start is the canonical context loader for every supported client; each persona invokes it as part of its startup sequence. metateam monitor is the transcript-upload fallback for environments where SessionEnd hooks are unavailable.

Monitor

$ metateam monitor [AGENTS]

Runs a background process that watches for AI agent sessions and uploads their transcripts when they finish.

Argument Default Purpose
codex yes Monitor Codex sessions
gemini Monitor Gemini sessions
claude Monitor Claude sessions (usually handled by hooks instead)

Examples:

$ metateam monitor                # Monitor Codex (default)
$ metateam monitor codex gemini   # Monitor both Codex and Gemini

How It Works

The monitor:

  1. Polls for running agent processes at regular intervals
  2. When an agent process is detected, opens a time window
  3. When the process exits, scans the agent's transcript directory for files modified during that window
  4. Uploads any new transcripts in the background

This is best-effort. It depends on:

  • Being able to detect the agent process (process name/PID matching)
  • Finding transcript files in the expected location
  • The transcript being complete when the process exits

For interactive setup and hook configuration, use metateam setup and metateam hook.

Start

$ metateam start [PROMPT]

Loads the context block (relevant past sessions, KB entries, recall) the agent should include in its prompt at session start. Each persona's startup sequence calls this; it is the canonical context loader for all clients (SessionStart hooks no longer inject context — see Hooks & Setup).

An agent invokes this once at session start and pipes the output into its context.

Option Purpose
--as <IDENTITY> Override identity as station:crew:persona (for debugging recall and context selection)

Example workflow:

$ metateam start "fix the auth module" > context.txt
$ metateam start --as bronto:titan:data "review this architecture"

If no prompt is provided, it uses an empty string and returns context based on the working directory and git metadata alone.