Skip to main content

Your First Session

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

Prerequisites​

Make sure IST is installed. Check that CLI tools are available:

ilogsession --version
isesh --version

If not installed, see the Installation guide.

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 ~/.loggable-session/logs/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 if profile exists
isesh profile list

Logs not appearing​

# Check session log directory
ls ~/.loggable-session/logs/

# View specific session logs
cat ~/.loggable-session/logs/my-first-session/*.txt | tail -50