logsession (Core)

logsession is the core tool for automatically logging Claude Code sessions. It runs Claude Code within a tmux session and records all terminal output.

Installation

# Install glpkg installer (one-time setup)
npm install -g @glpkg/installer

# Install loggable-session
gitlab-install @session-tools/loggable-session

Quick Start

# Start a session (auto-generated name)
logsession start

# Start with a specific name
logsession start my-project

# Start in the background
logsession start my-project --detach

CLI Commands

Session Management

Command	Description
logsession start [name] [options]	Start a new session (default: auto-attach)
logsession list [--json]	List all sessions
logsession show <name>	View session logs
logsession attach <name>	Reattach to a detached session
logsession stop <name>	Stop a session
logsession delete <name>	Delete a session (stop + remove logs)
logsession rename <old> <new>	Rename a session

Configuration Management

Command	Description
logsession config	Show current configuration
logsession config set interval <ms>	Set update interval
logsession config reset	Reset to defaults
logsession config workspace	Show workspace configuration

Profile Management

Command	Description
logsession profile	Show profile list
logsession profile list	List all profiles
logsession profile show <name>	Show profile details
logsession profile create <name> [opts]	Create a new profile
logsession profile delete <name>	Delete a profile

Miscellaneous

Command	Description
logsession info	Show app information
logsession init	Initialize app directory
logsession examples	View usage examples
logsession help	Show help
logsession --version	Show version

Key Options

start Command Options

logsession start [name] [options]

Options:
  --detach, -d                    Start in the background
  --show-context, -c              Automatically send previous logs to Claude
  --profile, -p <name>            Use a profile (system prompt, etc.)
  --claude-session-id <uuid>      Specify Claude Code session ID

Usage Examples

Basic Usage

# Start and enter a session
logsession start my-task

# Start in the background
logsession start my-task --detach

# Reattach later
logsession attach my-task

Resume Previous Work

# Automatically send previous logs to Claude
logsession start my-task --show-context
logsession start my-task -c  # Short form

Using Profiles

# Create a profile
logsession profile create dev --system-prompt "You are a dev assistant"

# Start a session with a profile
logsession start my-task --profile dev
logsession start my-task -p dev  # Short form

Adjusting Configuration

# Check current configuration
logsession config

# Adjust update interval (default: 200ms)
logsession config set interval 100   # Faster response (higher CPU)
logsession config set interval 500   # Battery saving

# Reset to defaults
logsession config reset

tmux Shortcuts

While attached to a session:

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

Log File Location

~/.loggable-session/
├── config.json          # Global configuration
├── profiles/            # Saved profiles
└── logs/
    └── <session-name>/
        └── <timestamp>.txt   # Log files

Integration with Other Tools

Logs created by logsession can be used with other Session Tools:

• logsession-monitor: Real-time session status monitoring
• log-analyzer: Log analysis and summary generation
• log-search: RAG-based semantic search
• session-messenger: Inter-session messaging

Version Info

• Current Version: 0.7.2
• License: SSPL-1.0
• Repository: GitLab