Skip to main content

Your First Session

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

Prerequisites​

Make sure IST is installed:

npx @anthropic-ist/setup check

Step 1: Choose Your Project​

Navigate to your project directory:

cd /path/to/my-project

Step 2: Start the Session​

ilogsession start my-first-session -p mwd

This starts a session with:

  • Name: my-first-session
  • Profile: mwd (Microwise Development)

Step 3: Work With the AI​

In Claude Code or Cursor, the AI now has:

  • MWD methodology guidelines
  • Automatic logging enabled
  • Micro-commit workflow

Example Interaction​

You: Add input validation to the signup form

AI: I'll add input validation following MWD principles.

Step 1: Add email format validation
[makes change, commits]

Step 2: Add password strength check
[makes change, commits]

Step 3: Add error message display
[makes change, commits]

Done! Each change is committed separately for easy review.

Step 4: Check Your Progress​

View the session logs:

ilogsession logs my-first-session

This shows:

  • All AI interactions
  • Commands executed
  • Commits made
  • Time spent

Step 5: Stop When Done​

ilogsession stop my-first-session

What Happened?​

During your session:

  1. Logging: Every interaction was logged to ~/.ist/sessions/my-first-session/
  2. Profile: The MWD profile guided the AI's behavior
  3. Commits: Changes were committed incrementally

Next Steps​

Troubleshooting​

Session won't start​

# Check if another session is running
ilogsession list

# Check for issues
npx @anthropic-ist/setup doctor

Logs not appearing​

# Check session status
ilogsession status my-first-session

# Ensure logging directory exists
ls ~/.ist/sessions/