Astra CLI

Minimal trace-finalization CLI for ASTRIX AI evaluation.

Commands

• astra start --team T123 initializes .astra/config.json and .astra/logs.json.
• astra finalize redacts sensitive content and uploads traces to /api/finalize.
• astra all (v0.2.0+): one command — collects local repo signals (git log, README, top-level tree, package.json hints) into .astra/logs.json, then finalizes. Pass --email (dashboard login) + --token; --team invite code is optional (server resolves team from email when Convex is deployed with this API).

One command (recommended)

npx @mdayan896/astra-cli all --email [email protected] --token YOUR_TOKEN --memberName "Your Name"

Optional: --team ABC12XY if email lookup is wrong or you need to force a squad.

Less typing (especially on Windows)

From your project folder, create a .env file (same folder you run npx in). The CLI loads it automatically and does not override variables you already set in the shell:

ASTRIX_API_TOKEN=your_token_here
[email protected]
ASTRIX_MEMBER_NAME=Your Name
ASTRIX_PROJECT_TITLE=My project
ASTRIX_PROJECT_DESCRIPTION=What it does
ASTRIX_PROJECT_FEATURES=auth,dashboard

Then on Windows CMD you only run:

npx @mdayan896/astra-cli finalize

401 Unauthorized on Windows? If you used set ASTRIX_API_TOKEN="abc...", CMD keeps the quote characters inside the variable, so the server rejects the token. Use no quotes: set ASTRIX_API_TOKEN=abc... or a .env file, or pass --token (CLI 0.1.2+ also strips accidental surrounding quotes).

One command: init + finalize

From CLI 0.1.2+, pass the invite code on finalize (creates/updates .astra/config.json, keeps existing logs.json):

npx @mdayan896/astra-cli finalize --team YOUR_INVITE_CODE --token YOUR_TOKEN --memberEmail [email protected] --memberName "Your Name"

submit is an alias of finalize (same flags).

You can also pass the token once (still ends up in shell history):

npx @mdayan896/astra-cli finalize --token YOUR_TOKEN --memberEmail [email protected] --memberName "Your Name"

Environment Variables

• ASTRIX_API_BASE (optional, default https://astrix.astraclub.space)
• ASTRIX_API_TOKEN (optional unless backend requires it)
• ASTRIX_PROJECT_TITLE
• ASTRIX_PROJECT_DESCRIPTION
• ASTRIX_PROJECT_FEATURES (comma-separated)
• ASTRIX_MEMBER_EMAIL (optional, contributor identity for team-level attribution)
• ASTRIX_MEMBER_NAME (optional)

Finalize flags

• --token <ASTRIX_API_TOKEN> (optional; otherwise use env or .env)
• --email or --memberEmail (dashboard email; omit team_id on the wire when only email is set — requires backend support)
• --memberName "Your Name"
• --team <INVITE> (optional when email resolves)

all flags

Same as finalize for --token, --email / --memberEmail, --memberName, optional --team.