Skip to main content

isesh

Session management and configuration CLI.

Commands​

start​

Start a new Claude Code session.

isesh start <name> [options]

Options:

  • -p, --profile <name> - Use a profile (mwd, tda-manager, tda-worker)
  • -w, --workspace <path> - Working directory
  • -d, --detach - Run in background (detached mode)

Examples:

# Start a manager session in background
isesh start project-mgr -p tda-manager -w /path/to/project -d

# Start a worker session
isesh start project-mgr-w1 -p tda-worker -w /path/to/project -d

# Start attached (foreground) session
isesh start my-session -p mwd -w .

list​

List all sessions.

isesh list

Output:

- project-mgr (tda-manager) [running]
    ~/my-project
- project-mgr-w1 (tda-worker) [stopped]
    ~/my-project

stop​

Stop a session.

isesh stop <name>

attach​

Attach to a running session.

isesh attach <name>

state​

Manage session state.

# List state items
isesh state list

# Get a state value
isesh state get <key>

# Set a state value
isesh state set <key> <value>

prompt​

Manage prompts.

# List available prompts
isesh prompt list

# Show a prompt
isesh prompt show <name>

Example:

isesh prompt show infra
isesh prompt show worker-management

profile​

Manage profiles.

# List profiles
isesh profile list

# Show profile details
isesh profile show <name>

Profile Format​

Profiles are Markdown files in ~/.ist/profiles/:

# Profile Name

Description of the profile.

## System Prompt

The instructions for Claude...

Session Naming Convention​

For TDA (Manager/Worker) pattern:

project-mgr           # Manager
project-mgr-w1        # Worker 1
project-mgr-w2        # Worker 2
project-mgr-frontend  # Role-based worker