본문으로 건너뛰기

Your First Session

A step-by-step guide to running your first IST session.

Prerequisites​

Make sure IST is installed:

isesh --version
itda list

If not installed, see Installation. If you have not enabled monitoring yet, log in once with detector-agent login.

Step 1: Choose Your Project​

Navigate to your project directory:

cd /path/to/my-project

Step 2: Start the Session​

Start a session with the manager profile, using the current directory as the working directory:

isesh start my-first-session -p tda-manager -w .

This starts a session with:

  • Name: my-first-session
  • Profile: tda-manager (manager role)
  • Working directory: current folder

Step 3: Work With the AI​

Attach to the session and give the AI a task in plain language:

isesh attach my-first-session

Example Interaction​

You: Add input validation to the signup form

AI: I'll add input validation to the signup form.

Step 1: Add email format validation
[makes change]

Step 2: Add password strength check
[makes change]

Step 3: Add error message display
[makes change]

Done!

To leave the session running while you step away, detach with Ctrl-b then d. The session keeps working in the background — reattach later with isesh attach my-first-session.

Step 4: Check Your Progress​

List your sessions at any time:

itda list

Every interaction is also logged under ~/.ist/logs/my-first-session/, so the full history is preserved even if the session restarts.

Step 5: Stop When Done​

Stop the session:

isesh stop my-first-session

What Happened?​

During your session:

  1. Sessions: The AI worked inside a named session bound to your project directory
  2. Logging: Every interaction was logged to ~/.ist/logs/my-first-session/
  3. Persistence: Logs are saved even if the session crashes or restarts

Next Steps​

Troubleshooting​

Session won't start​

# Check which sessions are running
itda list -a

# Check for tmux issues
tmux list-sessions

Session not appearing​

# List all sessions, including stopped ones
itda list -a

# Ensure the logs directory exists
ls ~/.ist/logs/