AI Assistant, Image Transfer & Webhooks

MTerm goes beyond basic terminal emulation with built-in AI assistance, seamless image transfer to remote servers, and webhook-based push notifications. These features are designed for developers who use AI coding tools and need to stay connected to their workflows.

AI Assistant

The AI Assistant is a floating panel that overlays the terminal, giving you instant access to AI-powered help without leaving your workspace.

How It Works

Tap the AI button on the soft key bar (or use the Command Palette) to open the floating assistant panel. The AI can see your terminal output and use it as context for its responses.

Key Features

Terminal context awareness — The assistant can read what is happening in your terminal, so you can ask “What does this error mean?” or “How do I fix this?” without pasting anything
Text selection integration — Select text in the terminal, then send it directly to the AI for analysis, explanation, or troubleshooting
Command suggestions with safety warnings — When the AI suggests a command, it flags potentially dangerous operations (like rm -rf or DROP TABLE) so you can make informed decisions
SSE streaming — Responses stream in real-time, word by word, so you do not have to wait for the full response to start reading
Multi-language support — The AI responds in the language matching your device locale

Claude Code Mode

MTerm includes a dedicated input mode designed specifically for working with Claude Code:

Floating input panel — A dedicated text input area optimized for composing longer prompts
Image and file attachments — Attach photos, screenshots, or files to send along with your prompt. This is particularly useful for sharing UI mockups, error screenshots, or design references with Claude Code
Full iPad input power — Use the full iPad keyboard, dictation, and clipboard features to compose your prompts comfortably

AI Assistant requires Pro plan + Subscription

Image Transfer

Upload images from your iPad or iPhone directly to your remote server over SFTP. This is designed for workflows where you need to get images onto a server quickly — attaching screenshots to bug reports, uploading assets for a web project, or sharing reference images with AI tools.

How It Works

Press Cmd + I or tap the image transfer button
Select photos from your device’s photo library
Choose the destination directory on the remote server
Configure compression and naming options
Upload

Configuration Options

Option	Description
Compression quality	Adjust JPEG compression to balance file size and image quality
Maximum size	Set a maximum dimension (width/height) for uploaded images
File naming	Choose between timestamp-based names, UUIDs, or sequential numbering
Target directory	Select the destination folder on the server. If it does not exist, MTerm creates it automatically

Smart Features

Auto-insert path — After upload completes, the remote file path is automatically inserted into your terminal. This means you can immediately reference the uploaded file in a command without manually typing the path.
Parallel uploads — Multiple images are uploaded simultaneously, making batch uploads fast even over slower connections.

Image Transfer requires Pro plan

Webhook Notifications

Webhook notifications let you receive push notifications on your device triggered by events on your remote server. This is the feature that makes it safe to leave MTerm and do something else while a long-running task is in progress.

Common Use Cases

Scenario	How It Works
Claude Code task completion	Set up a webhook that fires when Claude Code finishes generating code. You get a push notification and can return to review the output.
CI/CD pipeline alerts	Receive notifications when your build completes, tests pass or fail, or a deployment finishes.
Server monitoring	Get alerted when a server goes down, disk space runs low, or an error spike is detected.
Custom automation	Any system that can make an HTTP request can trigger a push notification on your device.

How It Works

MTerm provides a REST API endpoint for each webhook you create. Any system that can make an HTTP POST request can trigger a push notification. The API accepts a JSON payload with the notification title and body.

Webhook Configuration

Custom webhooks — Create webhooks with custom names and descriptions
Send history — View a log of all webhook events that have been received
Daily quotas — Webhook usage is metered to prevent abuse

Webhook Limits

Plan	Daily Webhooks
Free	10
Pro	100
Subscribe	Unlimited

Integration Example

To trigger a notification when a long-running script finishes:

# Add to the end of your script
curl -X POST https://api.mterm.app/webhook/YOUR_WEBHOOK_ID \
  -H "Content-Type: application/json" \
  -d '{"title": "Build Complete", "body": "Your project finished building successfully."}'

You can add similar calls to your CI/CD pipelines, cron jobs, monitoring scripts, or any other automated process.

Webhook Notifications require Subscription