Skip to main content

ish secret list

List secret keys for the active workspace (values never returned) Usage: ish secret list [options]

Options

--workspace <id>
string
Workspace ID; defaults to active workspace

ish secret set

Create or update a workspace secret Usage: ish secret set <key> [value] [options]

Arguments

key
Secret key (uppercase, e.g. GROQ_API_KEY) (required)
value
Secret value. Omit when using —value-file or —value-stdin. (optional)

Options

--value-file <path>
string
Read the value from a file on disk (use ”-” for stdin)
--value-stdin
boolean
Read the value from stdin (alias for —value-file -)
--description <text>
string
Optional description (what this secret is used for)
--scope <scope>
string
Visibility scope: agent | project (default: agent) Default: “agent”.
--workspace <id>
string
Workspace ID; defaults to active workspace

ish secret delete

Delete a workspace secret by key Usage: ish secret delete <key> [options]

Arguments

key
Secret key to delete (required)

Options

--workspace <id>
string
Workspace ID; defaults to active workspace
-y, --yes
boolean
Skip confirmation prompt (required in —json or non-TTY contexts)

Global flags

Every command accepts the global flags.
-V, --version
boolean
output the version number
-t, --token <token>
string
Auth token (or set ISH_TOKEN env var)
--token-file <path>
string
Read auth token from a file (preferred over —token / ISH_TOKEN)
--workspace <id>
string
Default workspace ID; per-subcommand —workspace overrides
--json
boolean
Output as JSON (auto-enabled when piped)
--get <field>
string
Extract a single field from the JSON response and print only its value (implies —json internally; supports dotted paths e.g. person.name)
--human
boolean
Force human-readable output even when stdout is piped (overrides JSON-when-piped auto-detection)
--fields <fields>
string
Comma-separated fields to include in JSON output (e.g. alias,name,status)
--verbose
boolean
Include full UUIDs and timestamps in JSON output
--no-color
boolean
Disable colored output (also honored: NO_COLOR env var)
-q, --quiet
boolean
Suppress progress messages on stderr (no-op for read commands that emit none)