What is IST?
Integrated Session Tools (IST) is a toolkit that supercharges your AI coding sessions with Claude Code, Codex, Cursor and more.
The Problem
When working with AI assistants on coding tasks:
- Sessions are isolated - no communication between multiple AI instances
- Context is lost when sessions restart
- Managing multiple AI workers is chaotic
- No way to monitor what AI agents are doing in real-time
The Solution
IST provides a set of CLI tools that make AI sessions persistent, coordinated, and observable:
| Tool | CLI Command | What it does |
|---|---|---|
| Sesh | isesh | Start, attach to, and configure sessions |
| TDA | itda | Manage teams of manager/worker sessions |
| Loggable CLI | ilogsession | Persistent session logs across restarts |
| Messenger | imessenger | AI agents can communicate with each other |
| Detector Agent | detector-agent | Session detection and monitoring |
Key Features
Sessions (isesh)
Start and attach to sessions bound to a working directory, with a profile that defines the session's role:
# Start a manager session in a project directory
isesh start my-project -p tda-manager -w ~/my-project
# Attach to it
isesh attach my-project
Manager / Worker Teams (itda)
A manager session can delegate work to worker sessions. Inspect and manage the whole team:
# List manager sessions
itda list
# View the manager/worker tree
itda tree -a
# Stop a manager and its workers together
itda stop my-project
Session Logging (ilogsession)
Every AI session is logged under ~/.ist/logs/, so the full history is preserved even when sessions restart.
Kits (skit)
skit — the standard format for packaging AI-agent instructions and tools as kits, usable by any agent through an adapter.
IST already provides adapters for Claude Code, Codex, Cursor and more, so you don't have to build one.
# Install a kit
skit install @ist/tda-kit
Monitoring (detector-agent)
Log in once with detector-agent login to enable session detection, auto-approval, and the web dashboard.
Quick Example
# Install IST
npm install -g @microwiseai/snapshot
snapshot install @ist/beta
# Start a manager and a worker in your project
isesh start myproj-mgr -p tda-manager -w ~/my-project
isesh start myproj-worker -p tda-worker -w ~/my-project
# Attach to the manager and give it a task in plain language
isesh attach myproj-mgr
Next Steps
- Quick Start - Get running in a few minutes
- Installation - Detailed setup guide
- Your First Session - A step-by-step walkthrough