loki/docs/testing/plans/10-cli-flags.md

Test Plan: CLI Flags

Feature description

Loki CLI accepts flags for model, role, session, agent, file input, execution mode, and various info/list commands. Flags determine the execution path through main.rs.

Behaviors to test

Early-exit flags

• --info prints info and exits
• --list-models prints models and exits
• --list-roles prints roles and exits
• --list-sessions prints sessions and exits
• --list-agents prints agents and exits
• --list-rags prints RAGs and exits
• --list-macros prints macros and exits
• --sync-models fetches and exits
• --build-tools (with --agent) builds and exits
• --authenticate runs OAuth and exits
• --completions generates shell completions and exits
• Vault flags (--add/get/update/delete-secret, --list-secrets) and exit

Mode selection

• No text/file → REPL mode
• Text provided → command mode (single-shot)
• --agent → agent mode
• --role → role mode
• --execute (-e) → shell execute mode
• --code (-c) → code output mode
• --prompt → temp role mode
• --macro → macro execution mode

Flag combinations

• --model + any mode → model applied
• --session + --role → session with role
• --session + --agent → agent with session
• --agent + --agent-variable → variables set
• --dry-run + any mode → input shown, no API call
• --no-stream + any mode → non-streaming response
• --file + text → file content + text combined
• --empty-session + --session → fresh session
• --save-session + --session → force save

Prelude

• apply_prelude runs before main execution
• Prelude "role:name" loads role
• Prelude "session:name" loads session
• Prelude "session:role" loads both
• Prelude skipped if macro_flag set
• Prelude skipped if state already has role/session/agent

Old code reference

• src/cli/mod.rs — Cli struct, flag definitions
• src/main.rs — run(), flag processing, mode branching