ilogsession
ilogsession is the log viewer for IST sessions: it shows what a session has printed and said, live or after the fact (tail, turn, turns, show).
Use isesh to start, list, attach to, stop and clean up sessions (isesh start, isesh list, isesh attach, isesh stop, isesh kill, isesh delete, isesh rename, isesh archive). ilogsession also has low-level session commands, listed under Low-level session commands, but they are not the normal path.
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>
Low-level session commands (advanced)
These commands act directly on the underlying logged session, without isesh's profile, workspace and state handling. For everyday use, run the matching isesh command. isesh attach, isesh stop and isesh kill pass through to this layer, so you get the same effect plus isesh's bookkeeping.
| ilogsession | Use instead |
|---|---|
ilogsession list | isesh list (or itda list for TDA teams) |
ilogsession start | isesh start |
ilogsession attach | isesh attach |
ilogsession stop | isesh stop |
ilogsession rename | isesh rename |
ilogsession delete | isesh delete, see the difference below |
list
List the sessions known to the logging layer.
ilogsession list [options]
Options:
--json, -j- Output as JSON
start
Start a bare session, with no profile or workspace.
ilogsession start [name] [options]
Options:
-d, --detach- Start in background--cli <type>- CLI type:claude(default),cursor,codex
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>
This is not the same as isesh delete:
| Command | What it removes |
|---|---|
ilogsession delete <name> | Stops the session and removes its logs |
isesh delete <name> | The session's config, state and prompts (logs are kept) |
isesh delete <name> --all | Config, state, prompts and logs |
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
init
Initialize the app directory.
ilogsession init
examples
Show usage examples.
ilogsession examples
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 |