ilogsession

ilogsession is the core CLI for viewing and managing AI coding session logs.

Session Creation

For creating sessions with profiles and workspace options, use isesh start instead.

Log Viewing Commands

tail

Show recent output from a running session (real-time).

ilogsession tail <session> [-n lines] [-r run]

Options:

• -n <lines> - Number of lines to show (default: 50)
• -r <run> - Which run to show (1 = current, 2 = previous, etc.)

Examples:

# Show last 50 lines of current session
ilogsession tail my-project

# Show last 100 lines
ilogsession tail my-project -n 100

# Show previous run's logs
ilogsession tail my-project -r 2

turn

Show a specific conversation turn.

ilogsession turn <session> <n>

Arguments:

• n — Turn number. Positive from start (1 = first), negative from end (-1 = last)

Examples:

# Show first turn
ilogsession turn my-project 1

# Show last turn
ilogsession turn my-project -1

turns

Show multiple recent turns.

ilogsession turns <session> [-n count] [range]

Options:

• -n <count> - Number of turns to show (default: 3)
• <from>-<to> - Show turns in range (e.g., 2-5)

Examples:

# Show last 3 turns (default)
ilogsession turns my-project

# Show last 5 turns
ilogsession turns my-project -n 5

# Show turns 2 through 5
ilogsession turns my-project 2-5

show

Show all logs for a session.

ilogsession show <session-name>

Session Management

list

List all sessions.

ilogsession list [options]

Options:

• --json, -j - Output as JSON

start

Start a new session (basic, without profile/workspace).

ilogsession start [name] [options]

Options:

• -d, --detach - Start in background
• --cli <type> - CLI type: claude (default), cursor, codex, gemini

note

For profiles and workspace, use isesh start:

isesh start my-session -p mwd -w /path/to/project

attach

Attach to a detached session.

ilogsession attach <name>

stop

Stop a running session.

ilogsession stop <name>

delete

Stop a session and remove its logs.

ilogsession delete <name>

rename

Rename a session.

ilogsession rename <old-name> <new-name>

Configuration

config

Manage configuration.

ilogsession config [show|set|reset]

Examples:

# Show config
ilogsession config

# Set update interval (ms)
ilogsession config set interval 200

# Reset to defaults
ilogsession config reset

info

Show application info.

ilogsession info

Session Logs

Session logs are stored in ~/.ist/logs/<session-name>/.

Each log file is named with a timestamp (e.g., 2024-01-15_10-30-00.txt).

tmux Shortcuts

While inside a session:

Shortcut	Action
Mouse wheel	Scroll up/down
Ctrl+B [	Enter copy mode (arrows, PgUp/PgDn, 'q' to exit)
Ctrl+B D	Detach from session (keeps running)
Ctrl+D or exit	End session