iloso CLI

First-party CLI for ilo.so.

The published package bundles its API client, so users only install iloso.

Setup

Install the CLI:

npm install -g iloso

Create a workspace API key in the web app, then save it locally:

iloso auth token sk_ilo_...

Or start browser login when the app is available:

iloso auth login

For local development:

iloso auth token sk_ilo_... --base http://localhost:3000

You can also use environment variables:

ILO_API_KEY=sk_ilo_... iloso credits
ILO_API_BASE_URL=http://localhost:3000 iloso credits
ILO_WORKSPACE_ID=workspace_... iloso credits

Commands

iloso auth status
iloso keys list
iloso keys create --name "Claude" --scopes credits:read,posts:read,drafts:write,posts:publish
iloso keys revoke <key-id>
iloso credits
iloso credits history --limit 20
iloso connections list
iloso connections get <connection-id>
iloso connections auth x --open
iloso platforms list
iloso drafts list --limit 10
iloso drafts get <draft-id>
iloso drafts status <draft-id>
iloso drafts create --connection <connection-id> --body "Post text"
iloso drafts update <draft-id> --title "New title"
iloso drafts discard <draft-id>
iloso drafts schedule <draft-id> --scheduled-for 2026-06-01T10:00:00.000Z
iloso drafts cancel <draft-id>
iloso drafts publish <draft-id>
iloso threads create --connection <connection-id> --posts-file thread.json
iloso targets update <target-id> --body "Updated post text"
iloso posts list --limit 10
iloso posts scheduled
iloso posts estimate --platform x --body "Post text"
iloso posts preflight --connection <connection-id> --posts-file thread.json
iloso posts attempts --draft <draft-id>
iloso posts metrics <published-post-id> --refresh
iloso posts schedule <target-id> --scheduled-for 2026-06-01T10:00:00.000Z
iloso posts cancel <target-id>
iloso posts delete <published-post-id>
iloso posts delete <published-post-id> --local
iloso publish <target-id>
iloso smoke x --connection <connection-id> --posts-file thread.json
iloso smoke x --connection <connection-id> --posts-file thread.json --publish

Add --json to any read/write command for structured output. When an API request fails with --json, stderr is also one JSON object with the HTTP status and API body.

The full agent publishing flow is documented in docs/agent-publishing-flow.md.

Every command group and subcommand has local help:

iloso posts help
iloso posts metrics help
iloso threads create --help

The package also exposes an ilo binary as a compatibility alias.