Skip to main content

Project Structure

Session Tools is a collection of packages for managing and monitoring Claude Code sessions. All packages are published to the GitLab NPM registry under the @session-tools namespace.

Package Overview​

┌─────────────────────────────────────────────────────────────────┐
│                      @session-tools                              │
├──────────────────────┬──────────────────────────────────────────┤
│  logsession          │  Core session logging CLI                │
│  logsession-monitor  │  Real-time monitoring web UI             │
│  session-messenger   │  Inter-session communication             │
│  log-analyzer        │  Log analysis and summaries              │
│  log-search          │  RAG-based semantic search               │
│  docs                │  This documentation site                 │
└──────────────────────┴──────────────────────────────────────────┘

Packages​

logsession (Core)​

The foundation of Session Tools. Provides automatic logging for Claude Code sessions running in tmux.

# Start a logged session
logsession start my-project

# List active sessions
logsession list

# Show session output
logsession show my-project

Repository: session-tools.ver1.loggable-session

logsession-monitor​

Real-time web interface for monitoring multiple Claude Code sessions. Detects session states and provides ambient sound notifications.

# Start the monitor server
logsession-monitor

Features:

  • Real-time status updates via WebSocket
  • Session state detection (active, idle, waiting, stuck)
  • Ambient sound notifications
  • Multi-session dashboard

Repository: session-tools.ver1.logsession-monitor

session-messenger​

Send messages between Claude Code sessions. Useful for coordinating work across multiple sessions.

# Send a message to another session
messenger send target-session "Hello from here"

# Wait for a response
messenger wait --timeout 30

Repository: session-tools.ver1.session-messenger

log-analyzer​

Analyze session logs and generate summaries. Helps track what was accomplished in each session.

# Analyze a session's logs
log-analyzer analyze my-project

# Generate summary
log-analyzer summary my-project

Repository: session-tools.ver1.log-analyzer

RAG-based semantic search across session logs using LanceDB and Voyage embeddings.

# Index logs
log-search index my-project

# Search
log-search query "authentication bug fix"

Repository: session-tools.ver1.log-search

Architecture Diagram​

┌──────────────────────────────────────────────────────────────────┐
│                         User                                      │
└──────────────────────────────────────────────────────────────────┘
                              │
              ┌───────────────┼───────────────┐
              ▼               ▼               ▼
┌──────────────────┐ ┌──────────────┐ ┌──────────────────┐
│  logsession CLI  │ │   monitor    │ │   messenger      │
│  (start/list)    │ │   (web UI)   │ │   (send/wait)    │
└──────────────────┘ └──────────────┘ └──────────────────┘
         │                   │               │
         ▼                   ▼               ▼
┌──────────────────────────────────────────────────────────────────┐
│                    ~/.loggable-session/logs/                      │
│                      (session log files)                          │
└──────────────────────────────────────────────────────────────────┘
         │                                   │
         ▼                                   ▼
┌──────────────────┐               ┌──────────────────┐
│   log-analyzer   │               │    log-search    │
│   (summaries)    │               │   (RAG search)   │
└──────────────────┘               └──────────────────┘

Installation​

All packages are available from the GitLab NPM registry:

# Install glpkg installer first
npm install -g @glpkg/installer

# Install session-tools packages
gitlab-install @session-tools/loggable-session
gitlab-install @session-tools/logsession-monitor
gitlab-install @session-tools/session-messenger
gitlab-install @session-tools/log-analyzer
gitlab-install @session-tools/log-search

Session Tools works well with GitDot, a repository management dashboard that helps visualize and organize your GitLab/GitHub projects.

To view all Session Tools repositories:

  1. Go to GitDot Beta
  2. Select GitLab as the platform
  3. Enter microwiseai in the group field
  4. Click Load to see all repositories

License​

All packages are licensed under SSPL-1.0.

Copyright (C) 2024-2025 MicrowiseAI