Skip to main content

isesh

isesh is the session configuration CLI for creating sessions with profiles, workspace, and managing state/prompts.

Starting Sessions​

start​

Start a session with profile and workspace options.

isesh start <name> [options]

Options:

  • -p, --profile <name> - Profile to use (mwd, tda-manager, tda-worker, etc.)
  • -w, --workspace <path> - Working directory for the session
  • -d, --detach - Start in background
  • --cli <type> - CLI type: claude, cursor, codex, gemini

Examples:

# Start with MWD profile
isesh start my-task -p mwd

# Start with profile and workspace
isesh start my-project -p mwd -w ~/projects/my-app

# Start Manager session
isesh start project-mgr -p tda-manager -w ~/projects/my-app

# Start Worker session
isesh start worker1 -p tda-worker -w ~/projects/my-app

# Start with different CLI
isesh start my-task -p mwd --cli cursor

list​

List all sessions with their configurations.

isesh list [options]

Options:

  • --json, -j - Output as JSON

show​

Show session configuration.

isesh show <name>

Profile Management​

profile list​

List available profiles.

isesh profile list

profile show​

Show profile details.

isesh profile show <name>

Example:

isesh profile show mwd
isesh profile show tda-manager

Prompt Management​

prompt list​

List available prompts.

isesh prompt list

prompt show​

Display a prompt's content.

isesh prompt show <name>

Example:

isesh prompt show worker-management

prompt add​

Add a new prompt (pipe content via stdin).

echo "Your prompt content" | isesh prompt add <name>

prompt delete​

Delete a prompt.

isesh prompt delete <name>

State Management​

Session state persists data across restarts.

state list​

List all state keys.

isesh state list

state get​

Get a state value.

isesh state get <key>

Example:

isesh state get current-task

state set​

Set a state value.

isesh state set <key> <value>

Example:

isesh state set current-task "Implement user authentication"

state delete​

Delete a state value.

isesh state delete <key>

Session Control​

These commands are passed through to ilogsession:

isesh attach <name>   # Attach to session
isesh stop <name>     # Stop session
isesh kill <name>     # Kill session

Configuration​

Profiles are stored in ~/.ist/profiles/.

State is stored in ~/.ist/state/.

Prompts are stored in ~/.ist/prompts/.