Account

Commands for setup, authentication, API keys, settings, and account activity logs.

First-Time Setup

$ metateam setup [--username USERNAME] [--password PASSWORD]

Runs initial setup and stores config in ~/.metateam/config.json.

Login

$ metateam account login [USERNAME] [PASSWORD]

Authenticates with the API and saves your API key locally. If arguments are omitted, it prompts interactively.

Register

$ metateam account register [USERNAME] [PASSWORD] [EMAIL] [COMPANY]

Creates a new account. In non-interactive environments, pass --agree-tos.

Note: Do not run account register or account login without arguments in non-interactive environments (scripts, hooks) because they prompt for input.

Confirm Email

$ metateam account confirm-email [EMAIL] -t <TOKEN>

Confirms your email address with a verification token.

Show Current User

$ metateam account whoami

Shows the current authenticated user.

API Keys

$ metateam account keys list
$ metateam account keys create --name <NAME>
$ metateam account keys revoke <ID>

API keys are stored as SHA256 hashes server-side. The plaintext key is shown once on creation.

Settings

$ metateam account settings              # Show all settings
$ metateam account settings KEY=VALUE    # Set a value
$ metateam account settings KEY          # Get a value

Key Settings

Setting Default Purpose
inject_summary false Include session summaries in SessionStart context injection
debug false Enable debug logging for CLI operations
auto_index_on_session_end false Automatically run incremental repo index on session end
auto_generate_tags true API auto-generates tags for uploaded sessions
auto_generate_summaries true API auto-generates summaries for uploaded sessions
max_context_results 10 Max sessions returned by SessionStart context injection
min_conversation_length 50 Minimum transcript length (chars) to save a session

Activity Log

$ metateam account log [--category <CATEGORY>] [--severity <SEVERITY>] [--cursor <CURSOR>] [--limit <N>]

View account activity and audit records.

Configuration File

The config file lives at ~/.metateam/config.json. It stores:

  • api_url -- API endpoint (default: https://api.metateam.ai/v1)
  • api_key -- API key

Treat this file like a password. Do not commit it to git.