OpenProgram Docs
secrets#
usage: openprogram providers [-h] verb ...
secrets login#
Log into a provider
| Option | Description |
|---|---|
provider |
Provider id (e.g. openai-codex, anthropic) |
--account ACCOUNT |
Account (default: default) |
--method METHOD |
Advanced: force a specific login method. Omit it and the right one for the provider is picked automatically. |
--api-key API_KEY |
Supply the API key non-interactively (scripts / agents). Implies --method api_key; skips the prompt. WARNING: visible in shell history and ps — prefer --api-key-stdin or an env var. |
--api-key-stdin |
Read the API key from stdin (until EOF), non-interactively. Implies --method api_key. e.g. printf %%s "$KEY" | openprogram providers login minimax-cn --api-key-stdin. |
secrets list#
List pools per account
| Option | Description |
|---|---|
--account ACCOUNT |
Filter to one account (default: all) |
--json |
Output JSON |
secrets available#
Show all providers OpenProgram knows about — the built-in ones plus the community catalogue (models.dev). This is the list you pick an id from for openprogram providers login <id>. Pass a QUERY to filter by id or label (case-insensitive substring), e.g. providers available minimax.
| Option | Description |
|---|---|
query |
Filter to providers whose id or label contains this text. |
--json |
Output JSON (for scripts / agents). |
--configured |
Only show providers that already have a key / credential. |
secrets search#
Show all providers OpenProgram knows about — the built-in ones plus the community catalogue (models.dev). This is the list you pick an id from for openprogram providers login <id>. Pass a QUERY to filter by id or label (case-insensitive substring), e.g. providers available minimax.
| Option | Description |
|---|---|
query |
Filter to providers whose id or label contains this text. |
--json |
Output JSON (for scripts / agents). |
--configured |
Only show providers that already have a key / credential. |
secrets catalog#
Show all providers OpenProgram knows about — the built-in ones plus the community catalogue (models.dev). This is the list you pick an id from for openprogram providers login <id>. Pass a QUERY to filter by id or label (case-insensitive substring), e.g. providers available minimax.
| Option | Description |
|---|---|
query |
Filter to providers whose id or label contains this text. |
--json |
Output JSON (for scripts / agents). |
--configured |
Only show providers that already have a key / credential. |
secrets discover#
Scan external sources
| Option | Description |
|---|---|
--json |
Output JSON |
secrets adopt#
Adopt a discovered credential into the store
| Option | Description |
|---|---|
source_id |
Source id from discover output (e.g. codex_cli, env:OPENAI_API_KEY). Omit when using --all. |
--account ACCOUNT |
Target account (default: default) |
--all |
Adopt every credential discover() finds. Skips pools that already contain the same credential_id. |
secrets logout#
Remove credentials for a provider
| Option | Description |
|---|---|
provider |
Provider id to log out of |
--account ACCOUNT |
Account to remove credentials from |
--yes |
Skip confirmation |
secrets status#
Check a provider's current credential
| Option | Description |
|---|---|
provider |
Provider id to check |
--account ACCOUNT |
Account to check |
secrets use#
Set which account (account) a provider runs on
| Option | Description |
|---|---|
provider |
Provider id |
account |
Account to activate; omit to clear back to the default |
secrets doctor#
Diagnose credentials (expiry, refresh, cooldown, conflicts)
| Option | Description |
|---|---|
--json |
Output JSON |
secrets setup#
Interactive first-time setup
secrets aliases#
List provider short-name aliases
| Option | Description |
|---|---|
--json |
Output JSON |
secrets migrate#
Migrate stored credentials to the current format
secrets accounts#
Account management
| Subcommand | Description |
|---|---|
secrets accounts list |
List accounts |
secrets accounts create |
Create an account |
secrets accounts delete |
Delete an account |