projects
Create, list, and inspect Solwyn projects from the CLI
projects has three subcommands. create and list require a JWT (an email/password login); show accepts any credential.
projects create
Create a project and capture its first API key exactly once.
solwyn projects create --name <name> [--budget FLOAT] [--period daily|weekly|monthly] [--mode alert_only|hard_deny] [--store-key]| Option | Type | Default | Purpose |
|---|---|---|---|
--name | string | required | Name for the new project. |
--budget | float > 0 | 100.0 | Initial budget in USD. |
--period | daily | weekly | monthly | monthly | Initial budget period. |
--mode | alert_only | hard_deny | alert_only | Initial enforcement mode. |
--store-key | boolean | false | Store the new key in the OS keychain instead of printing it. |
| Contract | |
|---|---|
| Auth | JWT |
| Exit codes | 0 success · 1 generic/API · 2 usage · 3 auth |
| JSON schema | solwyn.projects-create.v1 |
The new project key is revealed exactly once, in a panel below the metadata. Save it before you close the terminal — it cannot be retrieved again. Pass --store-key to write it straight to your OS keychain, in which case it is stored rather than printed.
$ solwyn projects create --name my-agent --budget 50 --period monthly
Field Value
ID proj_x1y2z3w4
Name my-agent
Budget limit 50.00
Budget period monthly
Budget mode alert_only
Created 2026-07-11T10:30:00Z
Key prefix sk_proj_a1b2c3d4e5f67890
╭─ One-time project key ─╮
│ sk_proj_a1b2c3d4e5f67890… │
╰─────────────────────────╯The panel prints the full key — sk_proj_ followed by 64 hexadecimal characters — shown here truncated. Use it as:
SOLWYN_API_KEYfor the CLI (or store it withsolwyn login --with-key)SOLWYN_API_KEY, or theapi_keyconstructor argument, for the Python SDK
With --store-key, no panel is printed; the table shows Stored true instead.
projects list
List every project your login can reach.
$ solwyn projects list
ID Name Budget Period Mode Created
proj_abc12345 my-agent 100.00 monthly alert_only 2026-06-01T09:00:00Z
proj_def67890 staging-bot 25.00 daily hard_deny 2026-06-14T16:45:00Z| Contract | |
|---|---|
| Auth | JWT |
| Exit codes | 0 success · 1 generic/API · 2 usage · 3 auth |
| JSON schema | solwyn.projects-list.v1 |
projects show
Show the project selected by the global project context.
$ solwyn --project proj_abc12345 projects show
Field Value
ID proj_abc12345
Name my-agent
Budget limit 100.00
Budget period monthly
Budget mode alert_only
Created 2026-06-01T09:00:00ZResolve the project with --project, SOLWYN_PROJECT_ID, or a default_project in your config file.
| Contract | |
|---|---|
| Auth | any (project key or JWT) |
| Exit codes | 0 success · 1 generic/API · 2 usage · 3 auth · 5 not found |
| JSON schema | solwyn.projects-show.v1 |
Related
keys— rotate or revoke a project key after creationbudget— set limits and enforcement for a project- SDK quickstart — use a project key from the Python SDK