term-llm
Docs → Reference → Session management

State

Session management

List, search, resume, tag, export, and prune local sessions stored in SQLite.

On this page

Session commands

term-llm sessions
term-llm sessions list --provider anthropic
term-llm sessions search "kubernetes"
term-llm sessions show 42
term-llm sessions export 42
term-llm sessions name 42 "investigate auth flow"
term-llm sessions tag 42 bughunt auth
term-llm sessions untag 42 auth
term-llm sessions browse
term-llm sessions gist 42
term-llm sessions delete 42
term-llm sessions reset
term-llm chat --resume=42

Sessions are numbered sequentially for convenience, so 42 and #42 both work.

Storage

Sessions are stored in SQLite at:

~/.local/share/term-llm/sessions.db

Session storage config:

sessions:
  enabled: true
  max_age_days: 0
  max_count: 0
  path: ""

CLI overrides:

term-llm chat --no-session
term-llm ask --session-db /tmp/term-llm.db ...

Conversation inspector

While in chat or ask, press Ctrl+O to open the conversation inspector.

Key Action
j/k Scroll up/down
g/G Go to top/bottom
e Toggle expand/collapse
q Close inspector

What sessions are for

Use sessions when you want:

  • resumable conversation state
  • transcript search
  • exported chat history
  • per-session naming and tagging

Use Memory when you want durable facts and behavioral insights that survive beyond one specific chat.