Skip to content
Docs Menu
Documentation

Sessions

Session lifecycle and storage defined in packages/nikcli/src/session.

Session Model

The Session.Info schema defines session metadata, timing, sharing, and permissions. Sessions are stored under Global.Path.data/storage.

Field Notes
idDescending identifier.
slugHuman-friendly slug.
projectIDProject scope identifier.
directoryWorking directory.
parentIDParent session (forks).
summaryDiff stats and optional diffs list.
shareShare URL when shared.
titleAuto-generated when not set.
timecreated/updated/compacting/archived timestamps.
permissionOptional per-session permission rules.
revertSnapshot revert metadata.

Storage Layout

Sessions, messages, parts, and diffs are stored as JSON files. See packages/nikcli/src/storage/storage.ts.

Sharing

Auto share

Auto-share is enabled when NIKCLI_AUTO_SHARE or config.share = "auto".