What is IST?
Integrated Session Tools (IST) is a toolkit that supercharges your AI coding sessions with Claude Code, Cursor, Codex CLI, or Gemini CLI.
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 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.
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