VSCode Extension (session-tools-ex)

The Claude Session Tools extension makes it easy to use logsession and monitor directly in VSCode. Manage sessions through the dashboard in the Activity Bar.

Installation

From VSCode Marketplace

Extensions > Search "Claude Session Tools" > Install

The extension automatically installs all required dependencies:

• @session-tools/loggable-session
• @session-tools/logsession-monitor

Manual Installation (VSIX)

# Build the extension
cd session-tools-ex/package
npm install
npm run package

# Install from VSIX file
code --install-extension claude-session-tools-0.0.1.vsix

Features

Command Palette

Press Ctrl+Shift+P (macOS: Cmd+Shift+P) to access these commands:

Command	Description
Session Tools: Open Log Monitor	Open the log monitor web UI
Session Tools: Open Session Manager	Open the session manager
Session Tools: Install Dependencies	Install required tools
Session Tools: Reinstall Dependencies	Reinstall tools

Activity Bar Dashboard

The Session Tools panel appears as a terminal icon in the left Activity Bar:

• Dashboard View: View session status at a glance
• Quick Actions: Quick access to monitor/manager
• Status Overview: List of currently running sessions

Settings

Search for Session Tools in File > Preferences > Settings:

Setting	Default	Description
session-tools.skipDependencyCheck	false	Skip dependency check on startup
session-tools.monitorPort	41820	logsession-monitor service port
session-tools.managerPort	41821	logsession service port

settings.json Example

{
  "session-tools.skipDependencyCheck": false,
  "session-tools.monitorPort": 41820,
  "session-tools.managerPort": 41821
}

Usage

1. Initial Setup

After installing the extension:

1. Click the Session Tools icon in the Activity Bar
2. Click "Install Dependencies" button or run from Command Palette
3. @session-tools/logsession and @session-tools/logsession-monitor are installed automatically

2. Open Monitor

Command Palette > Session Tools: Open Log Monitor

Or click "Open Monitor" in the Activity Bar dashboard

3. Open Session Manager

Command Palette > Session Tools: Open Session Manager

View and manage sessions in the web UI

Architecture

┌─────────────────────────────────────────────────────────┐
│                    VSCode Extension                      │
│              (claude-session-tools)                      │
├─────────────────────────────────────────────────────────┤
│  Activity Bar        │  Commands                         │
│  ┌───────────────┐   │  ┌─────────────────────────────┐ │
│  │  Dashboard    │   │  │ Open Log Monitor             │ │
│  │  (Webview)    │   │  │ Open Session Manager         │ │
│  │               │   │  │ Install Dependencies         │ │
│  └───────────────┘   │  │ Reinstall Dependencies       │ │
│                      │  └─────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
                            │
                            ▼
┌─────────────────────────────────────────────────────────┐
│                    CLI Tools                             │
│  ┌───────────────────┐  ┌───────────────────┐           │
│  │ logsession-monitor│  │ loggable-session  │           │
│  │ (port: 41820)     │  │ (port: 41821)     │           │
│  └───────────────────┘  └───────────────────┘           │
└─────────────────────────────────────────────────────────┘

Developer Guide

Build from Source

# Clone repository
cd session-tools-ex/package

# Install dependencies
npm install

# Compile
npm run compile

# Watch mode (for development)
npm run watch

Run Tests

# Run all tests
npm test

# Run Extension Development Host in VSCode
F5 (Start Debugging)

Packaging

# Generate VSIX file
npm run package

Requirements

System Requirements

• VSCode: 1.107.0 or later
• Node.js: 18.0 or later

CLI Tools

The extension installs these tools automatically:

• @session-tools/loggable-session (logsession CLI)
• @session-tools/logsession-monitor (monitor server)

Troubleshooting

Dependency Installation Failed

# Install manually
npm install -g @glpkg/installer
gitlab-install @session-tools/loggable-session
gitlab-install @session-tools/logsession-monitor

Port Conflict

If another service is using the port:

1. Change session-tools.monitorPort in Settings
2. Restart VSCode

Dashboard Not Loading

1. Open Developer Tools (Help > Toggle Developer Tools)
2. Check the Console tab for errors
3. Try reinstalling the extension

Version Info

• Current Version: 0.0.1
• Minimum VSCode Version: 1.107.0

Roadmap

Planned features:

• Session status in status bar
• Session start/stop buttons
• Built-in log viewer
• Keyboard shortcut support
• Multi-workspace support

Related Documentation

• logsession - Core logging tool
• logsession-monitor - Monitoring tool
• Getting Started - Getting started guide