CLI
Oblien CLI
The oblien CLI is a thin, zero-dependency wrapper around the Oblien SDK. Every command maps directly to an SDK method — no extra logic, no magic.
The same credentials power the CLI, SDK, and MCP server, so oblien login is all you need to get everything working.
Quick start
# Install globally
npm install -g oblien
# Log in (opens browser)
oblien login
# Create and start a workspace
oblien ws create --image node-20 --name my-app
oblien ws start ws_abc123
# Run a command inside it
oblien exec ws_abc123 -- npm test
# List files
oblien files ls ws_abc123 /appCommand groups
| Group | Description |
|---|---|
login / auth | Browser-based login, logout, status |
config | Manage credentials file directly |
ws | Create, list, start, stop, delete workspaces |
exec | Run commands inside workspaces |
files | Read, write, list, delete files |
search | Search code and filenames |
network | Network configuration |
ssh | SSH access management |
public-access | Expose and revoke public ports |
lifecycle | Permanent/temporary mode, TTL |
snapshots | Snapshots and archives |
images | Browse available images |
logs | View and stream logs |
terminal | Terminal sessions |
watcher | File system watchers |
workloads | Containers and processes |
metrics | Resource metrics |
usage | Credits and usage tracking |
metadata | Key-value metadata |
api-access | Runtime API tokens |
ns | Namespaces, quotas, usage |
skills | Agent skill management |
Global flags
Every command accepts these flags:
--json Output as JSON (default: human-readable table)
--client-id <id> Override client ID for this invocation
--client-secret <s> Override client secret for this invocation
--base-url <url> Override API base URL
-v, --version Show version
-h, --help Show helpAuthentication priority
Credentials are resolved in this order:
--client-id/--client-secretflagsOBLIEN_CLIENT_ID/OBLIEN_CLIENT_SECRETenvironment variables~/.oblien/credentials.json(written byoblien login)
The MCP server (oblien-mcp) uses the same resolution order, so oblien login authenticates both the CLI and MCP automatically.