CLI Reference
All CLI flags and options.
Usage
aspectcode [options]
aspectcode <command>Run in your project root. Requires login (run aspectcode login first).
Commands
| Command | Description |
|---|---|
aspectcode login | Sign in via browser (Google OAuth) |
aspectcode login | Sign in with a code from the dashboard |
aspectcode logout | Clear stored credentials |
aspectcode whoami | Show current logged-in user |
When no command is given, the default behavior is to analyze and watch.
Flags
| Flag | Description |
|---|---|
--once | Run once and exit (no watch mode) |
--dry-run | Preview without writing files (use with --once) |
--provider | LLM provider (openai, anthropic, or grok) |
--model | Model override |
--temperature | Sampling temperature (0–2) |
--compact | Compact dashboard layout |
--cursor | Target Cursor instead of Claude Code |
--verbose | Debug output |
--quiet | Suppress non-error output |
--root | Explicit workspace root |
--no-color | Plain text output |
--help | Show help |
--version | Show version |
Environment variables
| Variable | Description |
|---|---|
OPENAI_API_KEY | Enables LLM optimization via OpenAI |
ANTHROPIC_API_KEY | Enables LLM optimization via Anthropic |
When an API key is set, the evaluator and optimizer run automatically after static analysis. Without a key, AGENTS.md is generated through static analysis alone.