CLI commands

Run lookio --help or lookio <command> --help for the options of a command. lookio help --json prints the whole command tree as one JSON document, which is what an AI agent should read first. It is long: lookio help <command> --json (for example lookio help ask --json) describes one command alone.

Only lookio ask spends credits. Every other command is free.

Account

lookio account
lookio credits
lookio usage --from 2026-01-01 --to 2026-01-31 --granularity day

Resources

lookio resources list --type url --tag pricing --limit 50
lookio resources get RESOURCE_ID
lookio resources add-text --title "Refund policy" --from-file policy.md --tags legal,faq
lookio resources add-url https://example.com/pricing --title "Pricing"
lookio resources add-file ./handbook.pdf --tags hr
lookio resources update RESOURCE_ID --title "New title" --tags a,b
lookio resources content RESOURCE_ID
lookio resources reindex RESOURCE_ID
lookio resources delete RESOURCE_ID --force

add-text, add-url, add-file and sites add also take --tags a,b and --source, the text shown with every citation of the resource.

Sites

lookio sites preview https://example.com/docs
lookio sites add https://example.com --include "/docs/**" --exclude "/blog/**" --schedule every_3_days
lookio sites pages RESOURCE_ID
lookio sites rules RESOURCE_ID --include "/docs/**"
lookio sites retry RESOURCE_ID

The rule options are repeatable: --include, --exclude and --exclude-url. You can also pass --regex and --schedule manual|daily|weekly|monthly|every_N_days|every_N_weeks|every_N_months. Omit --schedule when adding a site to use the plan default: manual on Free, weekly on paid plans. Recurring schedules require a paid plan and range from 1-90 days, 1-52 weeks or 1-12 months. See Websites.

Assistants

lookio assistants list
lookio assistants get ASSISTANT_ID
lookio assistants create --name "Support" --context "You are the help center assistant of Acme, talking to customers" --resources ID1,ID2
lookio assistants create --name "Pricing bot" --follow-tags pricing
lookio assistants update ASSISTANT_ID --knowledge all
lookio assistants delete ASSISTANT_ID --force

Deleting an assistant needs the assistants:delete scope, and is refused while a widget uses it.

create and update take --name, --context, --output-guidelines, --resources <id,id>, --follow-tags <a,b> and --knowledge all|selected|tags. Lists you pass replace the previous lists. Without --knowledge, create infers it from the lists. update changes only the options you pass.

Asking questions

lookio ask ASSISTANT_ID "What is the refund window?"
lookio ask ASSISTANT_ID "And for annual plans?" --conversation CONVERSATION_ID
lookio ask ASSISTANT_ID "What is the refund window?" --end-user user_42
lookio ask ASSISTANT_ID "A private question" --no-store
lookio ask ASSISTANT_ID "Summarise the handbook" --mode deep --stream
lookio ask ASSISTANT_ID "And for annual plans?" --history-file turns.json

A non-streamed answer prints answer, citations, credit_cost, credits_remaining, and the conversation_id and the answer’s message_id to continue it and rate it (null with --no-store). See Conversations and end users.

In JSON mode, a streamed answer looks like this:

{"event":"status","data":{"phase":"searching"}}
{"event":"delta","data":{"text":"The refund window is "}}
{"event":"done","data":{"answer":"...","citations":[],"conversation_id":"CONVERSATION_ID","message_id":"MESSAGE_ID","credit_cost":30,"credits_remaining":970,"simulated":false}}

An error event ends the command with a failure, and out of credits ends it with exit code 7. See Streaming and Exit codes.

Conversations

lookio conversations list --assistant ASSISTANT_ID --end-user user_42 --limit 50
lookio conversations get CONVERSATION_ID
lookio conversations rename CONVERSATION_ID "Refund questions"
lookio conversations delete CONVERSATION_ID --force
lookio conversations feedback CONVERSATION_ID MESSAGE_ID down --comment "Out of date"

After lookio auth login these are your own chats, personal. With an API key they are the conversations it started, and --end-user on get, rename, delete and feedback makes a conversation of another end user answer not found. feedback works for API keys only: with a login it fails with feature_not_available (exit code 3). See Conversations and end users and Feedback on answers.

Logs

lookio logs conversations --rating down --channel widget,api --from 2026-10-01
lookio logs conversations --stats --widget WIDGET_ID
lookio logs get CONVERSATION_ID
lookio logs answers --result no_answer --channel widget,api
lookio logs answers --stats --from 2026-10-01
lookio logs indexing --status failed --resource RESOURCE_ID
lookio logs indexing --stats
lookio logs activity --origin cli,mcp --target-type assistant --from 2026-10-01

The workspace’s four logs. All commands are free. See Logs for what each one holds and how long it is kept.

logs list and logs stats are now logs conversations and logs conversations --stats.

Every list pages with --limit and --cursor, and prints More results: add --cursor … when there is another page. The cursors of answers, indexing and activity are opaque: pass them back unchanged. --stats prints the figures instead of the list, over the same filters, and ignores --limit and --cursor. --from and --to take an ISO 8601 date or timestamp. A value that is not allowed for --channel, --rating, --result, --status, --source-type, --origin or --target-type is refused before any request, with exit code 2.

conversations filters:

answers filters:

indexing filters:

activity filters:

Widgets

lookio widgets list
lookio widgets create --assistant ASSISTANT_ID --domain docs.acme.com --mode flash
lookio widgets update WIDGET_ID --status paused
lookio widgets update WIDGET_ID --setting accent=#0b5fff --setting sources=numbered_no_links
lookio widgets update WIDGET_ID --monthly-credits 5000 --limit-per-visitor-hour 30
lookio widgets duplicate WIDGET_ID
lookio widgets set-image WIDGET_ID launcher ./logo.png
lookio widgets set-image WIDGET_ID favicon ./favicon.ico
lookio widgets clear-image WIDGET_ID favicon
lookio widgets snippet WIDGET_ID --format embed
lookio widgets conversations WIDGET_ID
lookio widgets conversations WIDGET_ID CONVERSATION_ID
lookio widgets delete WIDGET_ID --force

A widget shows an assistant to anonymous visitors on a website. Managing widgets is free. Visitors’ answers are charged to the workspace in the widget’s mode. duplicate copies a widget under a new id, with its images, and counts against the plan’s widget limit. set-image takes launcher or favicon and a PNG, JPEG, WebP or GIF file (ICO too for the favicon) up to 256 KB, on paid plans.

create and update share these options:

The allowed domains and the sources values are explained in Access and limits and Appearance.

Tags

lookio tags list
lookio tags rename old-name new-name
lookio tags delete old-name --force

rename and delete are for workspace admins signed in with lookio auth login.

Members

lookio members list
lookio members set USER_ID --allow resources_create,api --deny mcp --assistants all

members set needs --assistants, a comma-separated list of ids or all, and it always replaces the member’s current list. --allow and --deny name permissions: resources_list, resources_create, resources_edit, resources_delete, assistants_create, assistants_edit, assistants_delete, api and mcp. The older spellings resourcesCreate and resources-create are still accepted. Paid plans only. See Members and permissions.

Escape hatch

lookio api GET "/resources?type=url&limit=50"
lookio api POST /tags/rename --data '{"from":"old","to":"new"}'

lookio api <method> <path> makes an authenticated request to any endpoint, with the same retries and the same error format. The path may start with /v1 or not, and may carry a query string. --data takes inline JSON, @file or - for standard input, and --header "Name: value" adds a header. The response is printed as the API returned it, envelope included.

Diagnostics and help