Skip to main content

Quick Start

Get IST running in under 5 minutes.

Prerequisites​

  • Node.js 18 or higher
  • npm
  • Claude Code or Cursor

Step 1: Install IST​

  1. Install the Integrated Session Tools extension from the VSCode Marketplace
  2. Open the IST Dashboard panel in VSCode sidebar
  3. Click IST Login to authenticate with your Google account
  4. Choose your package:
    • Minimal (Free): Core session tools
    • Full (License Required): All features including skits
  5. Click the install button for your chosen package

Option B: Via CLI​

# Install the snapshot CLI
npm install -g @microwiseai/snapshot

# Login with your Google account
ist login

# Install minimal package (free)
snapshot install @ist/minimal

# Or install full package (requires license key)
snapshot install @ist/full

Step 2: Verify Installation​

After installation, verify the CLI tools are available:

ilogsession --version
imessenger --version
isesh --version

Step 3: Start Your First Session​

Simple MWD Session​

# Navigate to your project
cd my-project

# Start a session with MWD methodology
ilogsession start my-session -p mwd

Manager/Worker Pattern (TDA)​

# Start a manager session (in one terminal)
isesh start project-mgr -p tda-manager -w /path/to/project -d

# Start a worker session (in another terminal)
isesh start project-mgr-w1 -p tda-worker -w /path/to/project -d

Step 4: Access the Monitor (Optional)​

To use the IST Monitor dashboard for real-time session tracking:

  1. Go to ism.microwiseai.com
  2. Sign in with the same Google account you used for ist login
important

The Monitor requires authentication with the same Google account used for CLI login. If accounts don't match, your sessions won't appear.

What's Next?​

Troubleshooting​

"Command not found" after installation​

Make sure npm global bin directory is in your PATH:

# Check npm global bin location
npm bin -g

# Add to PATH if needed (add to ~/.bashrc or ~/.zshrc)
export PATH="$(npm bin -g):$PATH"

License key required for Full package​

Contact MicrowiseAI to request a beta license key, or use the "Request Beta Access" button in the VSCode extension.