ish workspace list
List all workspaces
Usage: ish workspace list
ish workspace create
Create a new workspace (or reuse an existing one with —ensure)
Usage: ish workspace create [options]
Options
Workspace name Required.
Workspace description
Default base URL
Idempotent: if a workspace with this exact name already exists in the caller’s account, return it instead of creating. Useful on saturated accounts where create would 402/usage_limit_reached.
ish workspace get
Get workspace details
Usage: ish workspace get <id>
Arguments
id
Workspace ID (required)
ish workspace update
Update a workspace
Usage: ish workspace update <id> [options]
Arguments
id
Workspace ID (required)
Options
Workspace name
Workspace description
Default base URL
Brand logo image URL (shown on the workspace and on shared study links)
ish workspace delete
Delete a workspace (and ALL nested studies, asks, people, secrets, configs, sources, chat endpoints)
Usage: ish workspace delete <id> [options]
Arguments
id
Workspace ID (required)
Options
Skip confirmation prompt (required in —json or non-TTY contexts)
ish workspace site-access
Manage credentials for gated test sites (basic auth, session cookie, login form)
Usage: ish workspace site-access
ish workspace site-access status
Show which site-access methods are configured
Usage: ish workspace site-access status [options]
Options
Workspace ID; defaults to active workspace
ish workspace site-access basic-auth
Set HTTP basic auth credentials
Usage: ish workspace site-access basic-auth [options]
Options
Username (or ”-” to read from stdin) Required.
Password (or ”-” to read from stdin) Required.
Origin to bind credentials to; defaults to workspace base_url
Workspace ID; defaults to active workspace
ish workspace site-access cookie
Set a session cookie for sites that gate on a token (Vercel preview, Lovable, etc.)
Usage: ish workspace site-access cookie [options]
Options
Cookie name Required.
Cookie value (or ”-” to read from stdin) Required.
Origin to bind cookie to; defaults to workspace base_url
Workspace ID; defaults to active workspace
ish workspace site-access login
Set login form credentials a participant will type into the site
Usage: ish workspace site-access login [options]
Options
Username (or ”-” to read from stdin) Required.
Password (or ”-” to read from stdin) Required.
Workspace ID; defaults to active workspace
ish workspace site-access affirm-public
Mark the site as not requiring credentials
Usage: ish workspace site-access affirm-public [options]
Options
Origin to mark public; defaults to workspace base_url
Workspace ID; defaults to active workspace
ish workspace site-access clear
Clear configured site-access credentials
Usage: ish workspace site-access clear <method> [options]
Arguments
method
basic-auth | cookie | login | public | all (required)
Options
Workspace ID; defaults to active workspace
ish workspace info
Show workspace details + plan-limit usage counters
Usage: ish workspace info [options]
Options
Workspace ID; defaults to active workspace
ish workspace use
Set the active workspace (saved to ~/.ish/config.json)
Usage: ish workspace use [id] [options]
Arguments
id
Workspace alias or UUID (optional)
Options
Remove the active workspace from config
Global flags
Every command accepts the global flags.output the version number
Auth token (or set ISH_TOKEN env var)
Read auth token from a file (preferred over —token / ISH_TOKEN)
Default workspace ID; per-subcommand —workspace overrides
Output as JSON (auto-enabled when piped)
Extract a single field from the JSON response and print only its value (implies —json internally; supports dotted paths e.g. person.name)
Force human-readable output even when stdout is piped (overrides JSON-when-piped auto-detection)
Comma-separated fields to include in JSON output (e.g. alias,name,status)
Include full UUIDs and timestamps in JSON output
Disable colored output (also honored: NO_COLOR env var)
Suppress progress messages on stderr (no-op for read commands that emit none)