Skip to main content

Session Tools Overview

IST consists of several CLI tools that work together to manage AI coding sessions.

Tool Overview​

┌─────────────────────────────────────────────────────┐
│                   IST Ecosystem                      │
├─────────────┬─────────────┬─────────────┬───────────┤
│ ilogsession │  imessenger │    isesh    │   skit    │
│   Logging   │  Messaging  │   Config    │  Profiles │
└─────────────┴─────────────┴─────────────┴───────────┘

ilogsession​

Session logging and management

# Start a new session
ilogsession start my-session -p mwd

# List active sessions
ilogsession list

# View session logs
ilogsession logs my-session

# Stop a session
ilogsession stop my-session

Key features:

  • Persistent logging across session restarts
  • Profile-based configuration
  • Session state management

imessenger​

Inter-session messaging

# Send a message
imessenger send session-name "Your message"

# Check inbox
imessenger inbox

# Approve a permission request
imessenger approve session-name

# View message status
imessenger status session-name

Key features:

  • Async communication between AI sessions
  • Permission approval workflow
  • Message queuing

isesh​

Session configuration management

# List available profiles
isesh profile list

# Show profile details
isesh profile show mwd

# List prompts
isesh prompt list

# Show a prompt
isesh prompt show worker-management

Key features:

  • Profile management
  • Prompt templates
  • Session state persistence

skit​

Profile package manager

# Install a skit package
skit install @ist/tda-kit

# List installed packages
skit list

# Show package info
skit info

# Uninstall a package
skit uninstall @ist/tda-kit

Key features:

  • Install/uninstall profiles
  • Package versioning
  • Dependency management

How They Work Together​

User Request
     │
     ▼
┌─────────────────┐
│   ilogsession   │──── Starts session with profile
│    start -p     │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│     isesh       │──── Loads profile configuration
│   profile get   │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│    Session      │
│   (AI Agent)    │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│   imessenger    │──── Communicates with other sessions
│      send       │
└─────────────────┘

Data Locations​

DataLocation
Profiles~/.ist/profiles/
Prompts~/.ist/prompts/
Session logs~/.ist/sessions/
Messages~/.ist/messenger/
Configuration~/.ist/config.json

Common Workflows​

Starting a Solo Session​

ilogsession start my-task -p mwd

Manager/Worker Setup​

# Manager
ilogsession start mgr -p tda-manager

# Workers
ilogsession start w1 -p tda-worker
ilogsession start w2 -p tda-worker

# Manager delegates
imessenger send w1 "Task description"

Checking System Status​

# All sessions
ilogsession list

# Specific session messages
imessenger inbox

# Installed profiles
skit list