CLI Reference

Install the Looki CLI, sign in, and query your data from the terminal.

Installation

Install the CLI, connect your Looki account, and make your first query.

Terminal

npm install -g @looki-ai/cli
looki login
looki memory overview

Use a date you captured with Looki. Add --help to view command options, for example looki moment list --help.

Commands

Browse the reference or filter by what you’re looking for. Open a command for options and a copyable example.

21 commands

looki logout

Clear local credentials and revoke the session.

Example

looki logout

looki auth status

Check your session and current account.

--json

Example

looki auth status --json

looki auth refresh

Refresh your current credentials manually.

Example

looki auth refresh

looki memory overview

Read your current memory overview, grouped by category.

--json

Example

looki memory overview
looki memory overview --json

looki moment list

List moments by date or date range.

Use --date for a single day, or --from-date and --to-date for an inclusive range. These forms cannot be combined. Sort is asc or desc (default desc); limit is 1–100 (default 20).

--date--from-date--to-date--limit--sort--cursor--json

Example

looki moment list --date 2026-10-01 --limit 20

looki moment search "query"

Find a moment with natural language.

Limit is 1–100 (default 10). Keep the query, date filters, and limit unchanged when using a pagination cursor.

--from-date--to-date--limit--cursor--json

Example

looki moment search "coffee with Alex" --limit 10

looki moment dates

Find dates that have saved moments.

Both ends of the date range are required.

--from-date--to-date--json

Example

looki moment dates --from-date 2026-10-01 --to-date 2026-10-07

looki moment view <moment-id>

Read a moment in full.

--json

Example

looki moment view <moment-id> --json

looki moment files <moment-id>

List the media attached to a moment.

--only-highlight--limit--cursor--json

Example

looki moment files <moment-id> --only-highlight --limit 20

looki journal list

Browse your saved journals.

--date--from-date--to-date--limit--sort--cursor--json

Example

looki journal list --date 2026-10-01 --json

looki journal dates

List dates containing journal entries.

Both ends of the date range are required.

--from-date--to-date--json

Example

looki journal dates --from-date 2026-10-01 --to-date 2026-10-07

looki journal view <journal-id>

Read a saved journal and its attachments.

--json

Example

looki journal view <journal-id>

looki summary list

Retrieve saved daily, weekly, or chat summaries.

--type is required: daily, weekly, or chat. Daily and chat ranges allow up to 7 inclusive days; weekly allows up to 31 days, filtered by week end date. Choose --date or provide both range dates.

--type--date--from-date--to-date--json

Example

looki summary list --type daily --date 2026-10-01 --json

looki health list

Read your saved health reports.

Choose --date or provide both range dates. Ranges allow up to 30 inclusive calendar days.

--date--from-date--to-date--json

Example

looki health list --from-date 2026-10-01 --to-date 2026-10-07

looki chat history

Retrieve conversation messages, newest first.

--since is optional and requires an explicit timezone when supplied. Limit is 1–100 (default 10). Keep --since unchanged or omitted across pages.

--since--limit--cursor--json

Example

looki chat history --since "2026-10-01T09:00:00+08:00" --limit 10 --json

looki config list

List settings explicitly saved in your configuration.

--json

Example

looki config list --json

looki config set <key> <value>

Set a configuration value.

Example

looki config set language en

looki config get <key>

Read a setting, including applicable defaults.

Example

looki config get language

looki config unset <key>

Restore a setting to its built-in value.

Example

looki config unset language

looki config path

Print the path to your configuration file.

Example

looki config path

Scripting and pagination

Query commands return readable text by default. Add --json to receive the original server response without an interactive prompt.

Terminal

looki moment list --date 2026-10-01 --json
looki journal list --limit 10 --json

Output mode	Pagination behavior
Interactive terminal	Press Enter to load another page. Press Ctrl+C to exit. Normal output hides cursors.
Piped or redirected	Returns one page and never waits for input.
`--json`	Returns one original server response. When `data.has_more` is true, pass `data.next_cursor` to `--cursor`, keeping the query and filters unchanged.

Date ranges are inclusive. Use --date for one day, or combine --from-date and --to-date for a range.

Configuration

Your settings live in ~/.looki/config.toml. Set LOOKI_HOME to use another directory. Saved settings override the applicable defaults.

Terminal

looki config path
looki config list
looki config set language en
looki config get language
looki config unset language

Changing your API deployment requires signing in again. Use looki config unset <key> to return a setting to its built-in value.

Agent Integrations