evolve auth

Set EVOLVE_API_KEY to a key from the dashboard’s API keys page, then confirm which account and key the CLI is using:

export EVOLVE_API_KEY="your-api-key"
evolve auth status

Success prints your user ID, email, and key metadata, never the key value. Add --json for machine-readable output. --api-key <key> overrides the environment for one command.

Allow images on edith-1.1

edith-1.1 returns 403 images_not_enabled for image requests until you allow images for your account. Check the setting:

evolve auth images

Images on Edith for your API keys: off

Turn it on:

evolve auth images on

Images on Edith for your API keys: on

evolve auth images off turns it off again. The setting covers every API key on your account and is off by default. A change reaches edith-1.1 within a minute. You can also change it on the dashboard’s API keys page. For image limits and billing, see Usage and billing. --json prints {"edith_images":true} or {"edith_images":false} instead of the sentence. Turning the setting on or off needs a full-access key; a read-only key gets 403 read_only_key. Any word other than on or off is a usage error and exits with code 2.

Find your organizations

evolve auth org list
evolve auth org show acme

org show <slug> returns your role, member count, quotas, and current usage for that organization. Missing spend data prints unavailable; a recorded value includes its timestamp when available.

Option for `org list`	Meaning
`--search <text>`	Case-insensitive substring match on slug, display name, or role. Applies to JSON output too.
`--columns <keys\|all\|help>`	Select columns or list their names.
`-q`, `--quiet`	Print organization slugs only.
`--no-trunc`	Keep full terminal table cells.
`--no-headers`	Omit piped TSV headers.

This list has no --limit or --cursor option.

Create a team

evolve auth org create acme --display-name "Acme"

You become the organization owner. --display-name <text> is optional and defaults to the supplied name.

Invite and join

Owner creates an invitation

evolve auth org invite acme

The response includes an invite token and its expiry/use limits. Save the token; it is returned only when created. The CLI uses a 7-day expiry and unlimited uses, with no flags to change those limits.

Owner gives the token to a teammate

The command prints the token; it does not send the invitation for you.

Teammate joins with their own API key

evolve auth org join "$INVITE_TOKEN"

The teammate joins as a member. Set $INVITE_TOKEN to the token from the owner.

Set the default organization

Save a team
Show the default
Return to personal

evolve auth org use acme

evolve auth org use

evolve auth org use personal

This is a local CLI preference. It writes to $XDG_CONFIG_HOME/evolve/config.json, or ~/.config/evolve/config.json when XDG_CONFIG_HOME is unset or blank. The command does not verify membership; the server checks access when you create a resource.

Selection	Priority
`--org <name>` on a creation command	First.
Saved CLI default	Used when no organization flag is supplied.
Personal organization	Used when neither is set.

--org personal uses your personal organization for one command without changing the saved default. The default applies to job creation, dataset publishing, agent registration, and skill uploads. See Teams for ownership and permissions.

JSON output

evolve auth status --json

Command	JSON output
`status`	`{ user_id, email, key }`. `key` contains `id`, `label`, `created_at`, and `last_used_at`.
`images [on\|off]`	`{ edith_images }`, a boolean.
`org list`	Array of organizations.
`org show`	Organization with `member_count`, `quota`, and `usage`.
`org create`	Created organization.
`org invite`	Invitation metadata and its `token`.
`org join`	`{ org, already_member }`.
`org use`	`{ org, source, path }`. `source` is `config` or `personal`.
`org use <name>`	`{ org, path }` after saving. `org` is `null` when cleared with `personal`.

See identity and team response fields for the organization, invitation, quota, and usage fields. Global options apply to every auth command.

Start work

Inspect results

Manage resources