Lobster CLI
Connect to Omics-OS Cloud from your terminal
Install
Requires Node.js 22 or later.
npm install -g @omicsos/lobster
Verify:
lobster --versionLogin
lobster cloud login opens your browser for Omics-OS authentication and stores first-party CLI credentials locally. No Cognito tokens are relayed to your machine.
lobster cloud login # browser-based login
lobster cloud login --device # browserless / SSH: prints a URL + code to authorize from any browserKey Commands
| Command | What It Does |
|---|---|
lobster cloud login | Authenticate via browser |
lobster cloud login --device | Authenticate from SSH / headless environments |
lobster cloud logout | Revoke credentials and remove local credential material |
lobster cloud chat | Start an interactive cloud chat session |
lobster cloud chat --session-id <id> | Resume a specific session |
lobster cloud status | Show account info and usage |
lobster cloud session list | List your sessions |
lobster cloud files list <session> | List files in a session |
lobster cloud vector search "<query>" | Semantic search across ontology collections |
lobster init | Interactive setup wizard |
Global Flags
| Flag | Description |
|---|---|
--json | Output as JSON for scripting |
--endpoint <url> | Override API endpoint |
--no-color | Disable colored output |
--verbose | Show HTTP request details |
API Keys
For CI/headless use, generate an API key (omk_...) in your workspace settings and supply it via environment variable:
export OMICSOS_API_KEY=omk_your_key_here
lobster cloud session list --json