Windows Terminal Session Manager (s)

A CLI tool to define, save, and launch named Windows Terminal sessions with specific layouts and commands.

Installation

Ensure the tool is linked globally:

npm i wtsm -g

Usage Guide

1. Creating & Managing Sessions

Create a new session:

s create <name>
# Example:
s create work

Add current directory to a session: Navigate to the folder you want to add, then run:

s add <name>
# Example:
cd C:\Projects\MyBackend
s add work

It will ask for an optional startup command (e.g., npm start or git status).

Add interactively: If you don't provide a name, it will show a list:

s add

(Type the number or name of the session to select it)

2. Viewing Sessions

Interactive Explorer:

s ls

• ↑ / ↓: Navigate the list of sessions.
• →: View tabs inside the selected session.
• Ctrl+D: Delete the selected session or tab.
• q, Esc, or Ctrl+C: Exit.

3. Launching Sessions

Launch a session:

s <name>
# Example:
s work

Opens a new Windows Terminal window with all configured tabs.

4 Not implemented features

• currently only supports powershell
• Automatically use current shell profile
• Pane capture