Mample is a simple notification system that allows you to track the completion of long-running processes on your computer or browser. Its purpose is to notify you by sending customizable notifications from a single place to your phone when tasks are finished, so you don't have to wait in front of the screen.

How does it work?

Mample can generally be used in two different ways:

1. Pairing and Connection Management

Scan the QR code of the Mample extension in your browser using the green QR reader button in the bottom right corner of the home screen, or enter your terminal code in its place in the extension to connect instantly. You can view the connection in the "Connected Devices" section of your mobile app.

For your security, all extension connections are automatically disconnected after 23 hours. You can also manually disconnect instantly by clicking the "Disconnect" icon (broken chain) on your phone or from your extension.

2. Receiving Notifications by Selecting a Key (/mample)

After establishing the connection, type "/mample" at the end of your prompt on any site where you are performing a process. If you haven't selected a key for that site before, Mample's "Key Selection Screen" will automatically activate. Here, select the key that appears when the process starts but will disappear when the process ends (usually this is the stop button). When the key you selected disappears, the process will be finished and you will receive a notification. If you prefer, you can also select a key using the "Select Key" button in your extension. On the website where you have a selected key, if you say yes to the pop-up appearing at the bottom right of your screen asking if you want to receive a notification when your custom selected key becomes visible (by using the "Use Custom Key Selection" button in your extension), you will receive a notification when your selected key disappears. You can view and manage the sites where you have selected keys by clicking the menu icon (≡) in the extension.

3. Detailed Key Selection (IMPORTANT)

For Mample to correctly understand that your process is finished, the element you select must be one that remains on the screen during the process and disappears when it ends. You should select the tiny object that shows the actual status, not the outer frame representing the process.

4. Receiving Notifications Without Selecting a Key (/mamplen)

On system pre-selected popular websites (ChatGPT, Claude, Gemini, Perplexity, Grok, Poe, Kimi, Z-AI), no element selection is required. If you type "/mamplen" directly at the end of your prompt, a notification will be automatically sent to you when your process finishes, thanks to the key we pre-selected for you. If you press the "Use System Key" button in your extension, without needing any extra key selection, thanks to the key registered in the system, when you start the process, a pop-up will appear at the bottom right just like in Use Custom Key Selection, and when you confirm it, you will receive an instant notification when the process ends.

5. Receiving Notifications from Downloads

With the "Get Notifications on Downloads (>40MB)" option in your extension, you can receive a notification when files larger than 40 MB finish downloading in your browser.

1. CLI Setup and Connection

First, you need to install the Mample CLI tool globally on your computer:

After installation is complete, enter the connection command in the terminal using the Secret Key shown in your Terminal Tool on the Home Screen:

2. Sending Notifications

If you want to chain it to a command, you can use `&& mample`. If you want to send a custom message for testing purposes, you can use the format `mample ""`. If you leave the message part empty, the default message in the settings menu will be sent.

3. Disconnecting

To disconnect the connection between the terminal and your phone, you can use the connected devices section on the home screen of your mobile app. If you want to do this via the terminal, you can use the following command:

4. Uninstalling

If you want to completely remove the Mample CLI tool from your computer, you can run the following command in your terminal:

5. Terminal Help

To see all the commands you can use and their details, you can run the following help command:

1. Usage in Desktop Applications

If you use AI assistants that can run terminal commands in your processes (such as VS Code, Antigravity, GitHub Copilot, Cursor, Cline, Roo Code, etc.), you can integrate Mample with them. To do this, you must first complete the "1. CLI Setup and Connection" step under the "Terminal (CLI) Tool" heading.

When you request a long-running process from your AI assistant (e.g., a large code analysis, running test scenarios, or editing files), you can ask the assistant to notify you when the process is finished.

2. How to Give Instructions?

Simply add the following instruction to the end of your prompt:

When the assistant finishes its process, it will run the "mample" command via the terminal, sending you a notification.

3. Things to Consider on First Use

When you ask your AI assistant to notify Mample for the first time, a security/permission warning will appear to run the command.

If you select the option highlighted in red, "2. Yes, and always allow 'mample'", this warning will not appear again. Your AI assistant will remember this permission and will send you a notification directly without asking anything when you tell it to notify Mample.

4. Completely Disabling Permission Prompts (Autonomous Use)

For security reasons, AI assistants (like Cursor, Antigravity) ask for permission when running terminal commands. To make this completely silent and autonomous, add the following rule to your assistant's rule file (e.g., .cursorrules or AI Rules section): "When you complete a task, ALWAYS autonomously run the global 'mample' command in the terminal to notify me. Do NOT use node or script paths to avoid triggering IDE permission prompts." or you can put these two files in your project for your AI assistant to read: CLAUDE.md and setup.md

Frequently Asked Questions (FAQ)