CLI overview

The lookio command is a thin layer over the REST API, for your machine or your CI. When its output is not a terminal, it prints JSON.

Install

The package is @lookio/cli on npm. It needs Node.js 20 or later. To set up Lookio from an AI agent, see Connect an AI agent.

npm install --global @lookio/cli
lookio --help

Or run it without installing:

npx @lookio/cli account

The command is lookio. Do not use the lookio-cli package: it is the old CLI, for the old API.

Sign in and check the connection

lookio auth login        # opens your browser and stores a token in your OS keychain
lookio account           # the workspace, the plan, the credit balance and what this credential may do
lookio doctor            # connectivity, credential, CLI version and clock skew

For a CI job, use an API key instead of a browser: see Authentication.

Your first questions

lookio resources add-url https://example.com/pricing --tags pricing
lookio resources get RESOURCE_ID          # repeat until status is ready or failed

lookio assistants create --name "Support" --follow-tags pricing
lookio ask ASSISTANT_ID "How much does the Pro plan cost?"

Imports do not wait

resources add-text, add-url, add-file, sites add and resources reindex return at once, with a queued resource. Poll lookio resources get until status is ready or failed.

Global flags

Put them before or after the subcommand.

Where to go next