CLI commands

lookio <command> --help gives the options of a command. lookio help --json prints all commands as one JSON document: an AI agent reads it first. lookio help <command> --json describes one command.

Only lookio ask and lookio search spend credits. All other commands are 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

You can repeat --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. Without --schedule, a new site is manual on Free and weekly on paid plans. Recurring schedules need a paid plan: 1 to 90 days, 1 to 52 weeks or 1 to 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 and credits_remaining. It also prints the conversation_id and the answer’s message_id, which you can use to continue the conversation and rate the answer. Both IDs are 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.

Search passages

lookio search ASSISTANT_ID "credit notes" --limit 5

Returns the passages that best match the question, best first, without an answer, for your own model. 1 credit per search, whatever it finds. Lookio stores nothing. --limit is 1 to 20 (default 8). --history-file takes the previous messages, like ask. It works with your assistants and with public assistants.

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. With an API key, they are the conversations it started. With --end-user, get, rename, delete and feedback return not found for a conversation of another end user. 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 four logs of the workspace. All commands are free. See Logs.

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

Every list uses --limit and --cursor, and prints More results: add --cursor … when there is another page. Send the cursors back as they are. --stats prints the figures for the same filters, not the list, and ignores --limit and --cursor. --from and --to take an ISO 8601 date or timestamp. A value that is not valid for --channel, --rating, --result, --status, --source-type, --origin or --target-type fails 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. The workspace pays for visitors’ answers, at the widget’s mode. duplicate copies a widget under a new id, with its images, and counts against the plan’s widget limit. On paid plans, set-image takes launcher, header or favicon and a PNG, JPEG, WebP or GIF file up to 256 KB, or ICO for the favicon.

create and update share these options:

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

Public assistants

lookio public list --q vat
lookio public get ASSISTANT_ID
lookio ask ASSISTANT_ID "Is VAT due on a sale to a German company?"

lookio assistants publish ASSISTANT_ID --description "Answers questions on EU VAT for freelancers, from official guidance."
lookio assistants publication ASSISTANT_ID
lookio assistants unpublish ASSISTANT_ID --force

public list and public get read the directory, for free. Ask a public assistant with lookio ask or lookio search: your workspace pays. publish, publication and unpublish are for admins and are free. --description is 40 to 1,000 characters. See Public assistants.

Accesses

lookio accesses list
lookio accesses create --name "Partner integrations" --assistant ASSISTANT_ID="Billing questions" --protection keys --modes flash,deep --monthly-credits 5000
lookio accesses update ACCESS_ID --status paused
lookio accesses get ACCESS_ID
lookio accesses keys create ACCESS_ID --name "Northfield Partners" --monthly-credits 1000
lookio accesses keys update ACCESS_ID KEY_ID --daily-credits 100
lookio accesses keys revoke ACCESS_ID KEY_ID --force
lookio accesses delete ACCESS_ID --force

An access shares assistants with people outside the workspace. These commands are for admins and are free. The workspace pays for the callers’ questions.

keys create prints the secret (ak_live_...) once. Store it and give it to the client. A key’s ceilings apply inside the access’s ceilings.

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 specify 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. Pro and Custom 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