Skip to main content

Quick Start

Get IST running in 3 steps.

Prerequisites

Step 1: Install

npm install -g @microwiseai/ist-setup
ist login
ist-setup install

Log in first (required for the testing tier), then install. Run ist-setup doctor first if you want to check your environment.

Step 2: Start a session

isesh start my-project -p mwd

This opens an AI coding session with:

  • Session logging — everything is saved to ~/.ist/logs/
  • MWD profile — the AI follows incremental development practices
  • Tool access — the AI can use imessenger, isesh, and other IST tools

Step 3: Tell the AI what to do

Once inside the session, just talk to it:

"Add input validation to the signup form"

The AI works on your project, making incremental commits and using IST tools as needed. You don't need to type any IST commands — the AI handles everything.

That's it

There is no step 4. The AI reads its profile, knows what tools are available, and uses them automatically.

Going further

Multi-agent mode

Start a Manager session to coordinate multiple AI workers:

isesh start my-project -p tda-manager

Tell the Manager what you want, and it will create worker sessions, delegate tasks, and coordinate the work. See What happens when you start a session to understand the flow.

Reconnect to a session

isesh attach my-project

Check what's installed

ist-setup doctor

Next steps