Skip to main content

imessenger

Inter-session messaging for coordinating multiple AI sessions.

Installation​

Installed automatically via VSCode extension, or:

gitlab-install add @ist/messenger -g --group microwiseai

Commands​

Send a message​

imessenger send <target-session> "Your message here"

Options:

  • --no-reply - Don't wait for response (fire and forget)
  • --timeout <ms> - Custom timeout (default: 30000)

Check inbox​

imessenger inbox                    # Your inbox
imessenger inbox <session-name>     # Specific session's inbox

Approve permissions​

imessenger approve <session-name>           # Basic approval
imessenger approve <session-name> 2         # Approve + don't ask again

Examples​

Basic messaging​

# Send message and wait for reply
imessenger send worker-1 "Build the login component"

# Send without waiting
imessenger send worker-1 "Start the build" --no-reply

Permission handling​

When a session needs approval:

# Check what needs approval
imessenger inbox worker-1

# Approve the request
imessenger approve worker-1

Multi-session coordination​

Start multiple sessions:

isesh start mgr-frontend -d ./frontend
isesh start mgr-backend -d ./backend

Delegate tasks:

imessenger send mgr-frontend "Implement the header component with navigation"
imessenger send mgr-backend "Create the user API endpoints"

Check responses:

imessenger inbox

Message Format​

Messages can be:

  • Plain text instructions
  • Multi-line with context
  • Code snippets (in markdown)
imessenger send worker "Fix this bug:

The login form doesn't validate email format.
File: src/components/LoginForm.tsx
Line: 45

Add proper email validation."

Integration with isesh​

# Start sessions
isesh start coordinator
isesh start worker-a -d ./frontend
isesh start worker-b -d ./backend

# Send tasks
imessenger send worker-a "Handle frontend"
imessenger send worker-b "Handle backend"

# Check responses
imessenger inbox

Inbox Management​

# View all pending messages
imessenger inbox

# Clear processed messages (auto-cleared after reading)

Tips​

  1. Keep messages focused - One task per message
  2. Use --no-reply for fire-and-forget - When you don't need response
  3. Check inbox regularly - For permission requests
  4. Name sessions clearly - Makes messaging intuitive