$ man aimsg

Getting Started

aImsg lets you write, review, and edit code from iMessage. Text a command to your bot number and get AI-powered responses backed by your own API key.

Setup

1

Verify your phone

Visit /start, enter your phone number, and reply to the iMessage we send you. This links your number to your aImsg account.

2

Connect GitHub

Authorize aImsg to read your repositories. We only write to new branches when you explicitly confirm.

3

Select a repository

Choose a default repo so you can skip typing the full name every time. Change it anytime with /repo.

4

Add an API key

aImsg uses your own AI provider key (Anthropic, OpenAI, or Google). Your key is encrypted with AES-256-GCM. You can add this later from the dashboard.

5

Start messaging

Text your first command to your bot number. Try /ask "summarize this repo" to see it in action.

Commands

/askAsk a question about your codebase

Example: /ask summarize Watchtower-Labs/aimsg

/reviewGet an AI code review of a pull request

Example: /review Watchtower-Labs/aimsg#42

/editRequest a code edit — aImsg creates a branch and PR

Example: /edit add dark mode toggle to the sidebar

/prCreate a pull request from a description

Example: /pr fix the login redirect bug

/repoSet your default repository

Example: /repo Watchtower-Labs/aimsg

/linkLink or re-link your GitHub account

Example: /link

/statusCheck your account status, usage, and limits

Example: /status

/helpList all available commands

Example: /help

How it works

When you text a command to your bot number, aImsg receives it via iMessage, classifies the intent, and routes it to the right handler. The handler calls your AI provider (Claude, GPT-4, or Gemini) using your own API key, then texts back the response.

For write operations like /edit and /pr, aImsg creates a new branch and opens a pull request. Your main branch is never modified directly. You always confirm before any write happens.

Your API key is encrypted at rest with AES-256-GCM and only decrypted in-memory when processing your request. aImsg never stores your code — it reads from GitHub on demand and discards the content after the response is sent.

Usage limits

PlanMonthlyDaily
Trial25 total25 total
Starter ($5/mo)500 messages50 per day
Pro ($20/mo)Unlimited200 per day

Tips

Natural language works too. You don't have to use slash commands — just text a question about your code and aImsg will figure out the intent.

Set a default repo. Use /repo owner/name so every command defaults to that project.

Multiple AI providers. Add keys for Anthropic, OpenAI, and Google in the dashboard. Switch your default anytime.

iMessage only. aImsg works over iMessage (iPhone required). Messages are delivered as blue bubbles, not SMS.