Skip to main content

isesh

Session management CLI for AI sessions.

Installation​

Installed automatically via VSCode extension, or:

gitlab-install add @ist/sesh -g --group microwiseai

Commands​

Start a session​

isesh start <session-name>
isesh start <session-name> -p <profile>    # With profile
isesh start <session-name> -d <directory>  # In specific directory

Stop a session​

isesh stop <session-name>

List sessions​

isesh list                    # Active sessions
isesh list --all              # Include stopped

Attach to session​

isesh attach <session-name>

Session state​

isesh state list              # List state items
isesh state get <key>         # Get state value
isesh state set <key> <value> # Set state value

Prompts​

isesh prompt list             # List available prompts
isesh prompt show <name>      # Show prompt content

Profiles​

Profiles define session behavior and system prompts.

isesh start my-session -p my-profile

Available profiles can be installed via skit or created locally.

Examples​

Basic workflow​

# Start a session
isesh start my-project

# Work in the session...

# Stop when done
isesh stop my-project

Multi-session setup​

# Start main session
isesh start project-mgr

# Start additional sessions for parallel work
isesh start project-mgr-frontend -d ./frontend
isesh start project-mgr-backend -d ./backend

# Coordinate via imessenger
imessenger send project-mgr-frontend "Build the header component"

Session Directories​

Sessions are stored in:

~/.ist/sessions/<session-name>/

Logs are stored in:

~/.ist/logs/<session-name>/