# Command Reference This is a code-verified summary of the command tree configured in `Program.cs`. ## Global Notes - Running `straumr` with no arguments prints a banner and version panel. - Global `--no-color` is handled before Spectre command parsing and disables ANSI and link output. - Command nouns have short aliases: - `workspace` -> `ws` - `request` -> `rq` - `auth` -> `au` - `secret` -> `sc` ## Command Tree ### `list` ```text straumr list workspace|ws [--json] [--filter ] straumr list request|rq [--json] [--filter ] [-w|--workspace ] straumr list auth|au [--json] [--filter ] [-w|--workspace ] straumr list secret|sc [--json] [--filter ] ``` Common patterns: - `--json` emits arrays of DTOs. - `--filter` matches name substring or ID prefix. - `--workspace` targets a workspace without changing global state (request and auth only). ### `create` ```text straumr create workspace|ws [--output ] [-j|--json] straumr create request|rq [Name] [Url] [request options] [-j|--json] [-w|--workspace ] straumr create auth|au [Name] [auth options] [-j|--json] [-w|--workspace ] straumr create secret|sc [Name] [Value] ``` Request options: - `--method` - `-H|--header` (repeatable, `"Name: Value"` format) - `-P|--param` (repeatable, `"key=value"` format) - `--data` - `--type` (body type: `json`, `xml`, `text`, `form`, `multipart`, `raw`) - `--auth` - `-e|--editor` Auth options for non-interactive creation (requires `--type`): - `-t|--type ` — `bearer`, `basic`, `oauth2`, `oauth2-client-credentials`, `oauth2-authorization-code`, `oauth2-password`, `custom` - `-s|--secret ` — token for bearer auth - `--prefix ` — header prefix for bearer (default: `Bearer`) - `-u|--username ` — for basic auth or OAuth2 password grant - `-p|--password ` — for basic auth or OAuth2 password grant - `-g|--grant ` — OAuth2 grant type when `--type` is `oauth2`: `client-credentials`, `authorization-code`, `password` - `--token-url ` — OAuth2 token endpoint URL - `--client-id ` — OAuth2 client ID - `--client-secret ` — OAuth2 client secret - `--scope ` — OAuth2 scope - `--authorization-url ` — OAuth2 authorization URL (authorization code grant) - `--redirect-uri ` — OAuth2 redirect URI (default: `http://localhost:8765/callback`) - `--pkce ` — PKCE mode: `S256`, `plain`, `disabled` - `--custom-url ` — custom auth request URL - `--custom-method ` — custom auth request method (default: `POST`) - `--custom-header

` — custom auth request header in `"Name: Value"` format (repeatable) - `--custom-param ` — custom auth request param in `"key=value"` format (repeatable) - `--custom-body ` — custom auth request body content - `--custom-body-type ` — custom auth body type: `json`, `xml`, `text`, `form`, `multipart`, `raw` (default: `json`) - `--extraction-source ` — custom auth extraction source: `jsonpath`, `header`, `regex` - `--extraction-expression ` — custom auth extraction expression - `--apply-header-name ` — custom auth header name to apply (default: `Authorization`) - `--apply-header-template