lhc sessions
Manage Lakehousecat chat sessions. Sessions hold the conversation history between a user and a custom model.
Commands
sessions list
lhc sessions list [--archived]
| Flag | Description |
|---|---|
--archived | List archived sessions instead of active ones |
sessions get <id>
lhc sessions get <session-id>
Returns an error if the session does not exist.
sessions create
lhc sessions create --title <title>
| Flag | Required | Description |
|---|---|---|
--title | yes | Session title |
sessions update <id>
lhc sessions update <session-id> --title <new-title>
sessions delete <id>
lhc sessions delete <session-id>
sessions archive <id>
Move a session to the archive without deleting it:
lhc sessions archive <session-id>
sessions unarchive <id>
Restore an archived session:
lhc sessions unarchive <session-id>
sessions clone <id>
lhc sessions clone <session-id>
sessions search [query]
Search matches a substring of the session title. Message content is encrypted at rest and is never searched.
lhc sessions search "sales" [--archived]
lhc sessions search --tag RED # every red session, across all pages
| Flag | Description |
|---|---|
--archived | Include archived sessions in the search results. Also applies to --tag — without it, an archived session cannot be found by tag either |
--tag | Restrict to sessions tagged with this color (repeatable, OR-combined; valid colors: RED, YELLOW, GREEN, BLUE, PURPLE). Tags are per user and assigned in the UI — the CLI only filters by them |
The query is optional when --tag is given, but at least one of the two is required.
sessions statistics
lhc sessions statistics
sessions shared-by-me
lhc sessions shared-by-me
sessions shared-with-me
lhc sessions shared-with-me
sessions share <id>
Share a session with a user or group. Exactly one of --user or --group is required:
lhc sessions share a1b2c3d4-0000-0000-0000-000000000001 --user 3e7c3d4f-16ff-4914-8250-bbe693ab7224
lhc sessions share a1b2c3d4-0000-0000-0000-000000000001 --group 1 --permission write
| Flag | Default | Description |
|---|---|---|
--user | — | Target user ID (UUID) |
--group | — | Target group ID (integer) |
--permission | read | Permission level: read, write, owner |
sessions unshare <id>
Remove all shares from a session:
lhc sessions unshare <session-id>
sessions count
lhc sessions count