본문으로 건너뛰기

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

# List active sessions
ilogsession list

# View a session's full logs
ilogsession show my-session

# Follow a running session's output in real-time
ilogsession tail my-session

# Stop a session
ilogsession stop my-session

Sessions are typically created with isesh start (which adds profile and workspace support); ilogsession handles the underlying logging and log viewing.

Key features:

  • Persistent logging across session restarts
  • Live and historical log viewing
  • Works with the profile-based sessions created by isesh

imessenger​

Inter-session messaging

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

# List sessions
imessenger list

# Approve a permission request
imessenger approve session-name

# Discover available sessions
imessenger discover

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
     │
     ▼
┌─────────────────┐
│     isesh       │──── Starts session with profile
│    start -p     │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│     isesh       │──── Loads profile configuration
│  profile show   │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│    Session      │
│   (AI Agent)    │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│   imessenger    │──── Communicates with other sessions
│      send       │
└─────────────────┘

Data Locations​

DataLocation
Profiles~/.ist/profiles/
Prompts~/.ist/prompts/
Session logs (ilogsession)~/.loggable-session/logs/
Session logs (isesh)~/.ist/logs/
Configuration~/.ist/config.json

Common Workflows​

Starting a Solo Session​

isesh start my-task -p mwd -w .

Manager/Worker Setup​

# Manager
isesh start mgr -p tda-manager -w .

# Workers
isesh start w1 -p tda-worker -w .
isesh start w2 -p tda-worker -w .

# Manager delegates
imessenger send w1 "Task description"

Checking System Status​

# All sessions
isesh list

# TDA team tree
itda tree -a

# Installed profiles
skit list