Installation

Detailed installation guide for IST.

VSCode Extension (Recommended)

The easiest way to install IST is through the VSCode extension.

1. Install the Extension

Search for "Integrated Session Tools" in the VSCode Extensions marketplace, or install directly:

• VSCode Marketplace Link

2. Login

1. Open the IST Dashboard panel (click the IST icon in the sidebar)
2. Click IST Login
3. Complete Google authentication in the browser

3. Choose a Package

Package	Contents	Requirements
Minimal (Free)	Core CLI tools, session logging, messaging	IST Login
Full (License)	Minimal + all skits (flowlog, tda, messenger, etc.)	IST Login + License Key

Click the install button for your chosen package.

---

CLI Installation

For terminal-based installation without VSCode.

1. Install Snapshot CLI

npm install -g @microwiseai/snapshot

2. Login

ist login

This opens a browser for Google authentication.

3. Install a Package

# Free tier - core tools
snapshot install @ist/minimal

# Full tier - requires license key
snapshot install @ist/full

If installing the full package, you'll be prompted for a license key.

---

What Gets Installed

Minimal Package (@ist/minimal)

Package	CLI Command	Description
@ist/logsession	ilogsession	Session logging and management
@ist/messenger	imessenger	Inter-session messaging
@ist/sesh	isesh	Session configuration and state
@ist/smon	smon	Session monitoring
@ist/cli-auth	ist	Authentication CLI

Full Package (@ist/full)

Everything in Minimal, plus:

Package	CLI Command	Description
@ist/skit	skit	Profile/kit manager
@ist/flowlog-kit	-	Flowlog methodology kit
@ist/tda-kit	-	TDA (Manager/Worker) kit
@ist/messenger-kit	-	Messaging kit
@ist/mwd-kit	-	MWD methodology kit

Installed Profiles

Profiles are installed to ~/.ist/profiles/:

• tda-manager.md - Manager role for TDA pattern
• tda-worker.md - Worker role for TDA pattern
• mwd.md - MWD methodology profile

---

Verify Installation

# Check CLI tools
ilogsession --version
imessenger --version
isesh --version

# Check installed profiles
ls ~/.ist/profiles/

---

Updating

Via VSCode Extension

Click Reinstall in the IST Dashboard to update to the latest version.

Via CLI

# Update the snapshot CLI itself
npm update -g @microwiseai/snapshot

# Reinstall packages to get updates
snapshot install @ist/minimal
# or
snapshot install @ist/full

---

Uninstalling

Remove IST Packages

# Remove global npm packages
npm uninstall -g @ist/logsession @ist/messenger @ist/sesh @ist/smon @ist/cli-auth

# Remove IST data directory
rm -rf ~/.ist

Remove Snapshot CLI

npm uninstall -g @microwiseai/snapshot

---

Troubleshooting

Permission Errors

If you get EACCES errors:

# Option 1: Use npm prefix (recommended)
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# Option 2: Fix npm permissions
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

Login Issues

If ist login doesn't work:

1. Check your internet connection
2. Make sure you have a default browser configured
3. Try running with verbose logging: DEBUG=* ist login

Package Not Found

If snapshot install fails with "package not found":

1. Make sure you're logged in: ist login
2. Check your license key is valid (for full package)
3. Try with verbose output: snapshot install @ist/minimal --verbose