Skip to main content
Sessions persist to ~/.config/lukan/sessions/{id}.json. Each session stores:
  • Message history
  • Checkpoints
  • Token usage
  • Compaction metadata
  • Provider/model configuration
Session IDs are random 6-character hex strings.

​
Managing Sessions

​
In-Chat Commands

/resume              Open session picker to resume a saved session
/clear               Clear context and start fresh

​
Command Line

# Resume by ID
lukan --session <id>

# Continue most recent session
lukan -c

​
Session Picker

Open the session picker with /resume. Navigate with:
  • Up/Down - Navigate sessions
  • Enter - Select session
  • Space - Mark for deletion
  • Alt+A - Toggle select all
  • Alt+X - Delete marked
  • Escape - Close

​
Session Storage

Sessions are stored in ~/.config/lukan/sessions/. Each file contains:
  • Messages (user/assistant/tool calls)
  • Configuration (provider, model, temperature)
  • Token counts and usage
  • Compaction metadata
Delete sessions manually or use /chats delete <id>.