https://github.com/mohammad-mghn/agent-assist
Type / for permanent snippets or # for quick temp replies in any textarea or rich-text field across the web.
https://github.com/mohammad-mghn/agent-assist
assistant chrome-extension firefox-extension react tool xwt
Last synced: 1 day ago
JSON representation
Type / for permanent snippets or # for quick temp replies in any textarea or rich-text field across the web.
- Host: GitHub
- URL: https://github.com/mohammad-mghn/agent-assist
- Owner: mohammad-mghn
- License: mit
- Created: 2026-06-05T16:34:58.000Z (19 days ago)
- Default Branch: main
- Last Pushed: 2026-06-05T19:59:09.000Z (19 days ago)
- Last Synced: 2026-06-05T21:22:59.559Z (19 days ago)
- Topics: assistant, chrome-extension, firefox-extension, react, tool, xwt
- Language: TypeScript
- Homepage:
- Size: 3.38 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Agent Assist
Text shortcuts for support agents — anywhere you type.
Type / for permanent snippets or # for quick temp replies in any textarea or rich-text field across the web.
---
## What it does
Customer support, sales, and operations teams repeat the same messages all day — greetings, apologies, refund policies, escalation scripts. Copy-pasting from docs is slow. Switching tabs breaks flow.
**Agent Assist** brings your snippet library into every text field on the web. Create categorized shortcuts once, then expand them inline with a simple trigger. No context switching, no clipboard gymnastics.
---
## Features
### Expand snippets anywhere
Works in `` and `contenteditable` fields on any website — helpdesk tools, CRMs, chat widgets, email composers, and more.
### Two trigger types for two workflows
| Trigger | Kind | Best for |
|---------|------|----------|
| `/name` | **Permanent** | Team-approved replies in categories — greetings, policies, closings |
| `#name` | **Temporary** | One-off or session snippets that stay out of your main library |
### Smart inline menu
Start typing after `/` or `#` and a fuzzy-search dropdown appears with matching snippets. Navigate with arrow keys, confirm with Enter or Tab. Turn the menu off and keep keyboard-only replacement when you prefer.
### Organized snippet library
Group permanent shortcuts into color-coded categories. Browse and edit from accordion sidebars, clear categories in bulk, and switch between permanent and temp libraries without clutter.
### Backup and share
Export permanent and temp data as separate JSON files. Import libraries from teammates, restore backups, or ship starter packs to new agents. Sample files live in [`examples/`](examples/).
### Built-in test panel
Try `/` and `#` triggers directly in the dashboard textarea before using them on live tickets.
### Control when it runs
Toggle all triggers globally from the sidebar — the toolbar icon turns green when active and shows an **OFF** badge when disabled. Dropdown suggestions can be toggled independently from snippet replacement.
### Themes and languages
Light and dark UI themes. Full interface localization in English (US/GB), Persian, Arabic, Turkish, and Kurdish — including RTL layout where needed.
### Cross-browser support
Chrome, Edge, Brave, and Opera (MV3), plus Firefox (MV2).
---
## Usage
1. Click the extension icon to open the **dashboard**.
2. Toggle **Trigger** in the left sidebar to enable or disable in-page shortcuts.
3. Create **categories**, then add **permanent** (`/`) or **temp** (`#`) shortcuts in the center form.
4. Browse and edit shortcuts from the left sidebar accordions.
5. **Export** or **import** JSON from the right panel to back up or share libraries.
6. Test triggers in the built-in textarea on the right.
Sample import files:
- [`agent-assist-permanent.json`](examples/agent-assist-permanent.json) — 14 categories + 200 `/` shortcuts
- [`agent-assist-permanent.xlsx`](examples/agent-assist-permanent.xlsx) — same permanent library in Excel format
- [`agent-assist-temp.json`](examples/agent-assist-temp.json) — 10 `#` shortcuts
- [`agent-assist-temp.xlsx`](examples/agent-assist-temp.xlsx) — same temp shortcuts in Excel format
Regenerate from `examples/generate-examples.mjs` after editing templates.
### Toolbar icon
| Icon | Meaning |
|------|---------|
| Green | Extension active — triggers work on all sites |
| Red with `OFF` badge | Extension disabled — no triggers fire |
---
## Installation
### Prerequisites
- [Node.js](https://nodejs.org/) 18+
- [pnpm](https://pnpm.io/) (recommended) or npm
### Install and run locally
```bash
pnpm install
pnpm dev # Chrome — loads from .output/chrome-mv3-dev
pnpm dev:firefox # Firefox — loads from .output/firefox-mv2-dev
```
### Load the extension
**Chrome / Edge / Brave / Opera**
1. Open `chrome://extensions`
2. Enable **Developer mode**
3. Click **Load unpacked** → select `.output/chrome-mv3-dev`
**Firefox**
1. Open `about:debugging#/runtime/this-firefox`
2. Click **Load Temporary Add-on** → select `manifest.json` inside `.output/firefox-mv2-dev`
For production builds, project structure, and architecture details, see [DEVELOPMENT.md](DEVELOPMENT.md).
---
## Contributing
Contributions are welcome — whether it's a bug fix, a new locale, UI polish, or documentation.
### Getting started
1. **Fork** the repository and create a branch from `main`.
2. **Install** dependencies with `pnpm install`.
3. **Run** `pnpm dev` and load the unpacked extension to test your changes.
4. **Type-check** with `pnpm compile` before opening a PR.
### Guidelines
- Keep changes focused — one feature or fix per pull request.
- Match existing code style and conventions in the file you're editing.
- Update translations in `lib/i18n/messages/` if you add or change user-facing strings.
- Test in both a `` and a `contenteditable` field when touching insert or trigger logic.
- Do not commit secrets, API keys, or personal snippet data.
### Reporting issues
Open a GitHub issue with:
- Browser and version
- Steps to reproduce
- Expected vs. actual behavior
- Screenshots or screen recordings when helpful
---
## Team and contact
### Product owner
**Hassan Faraji**
[](mailto:mrmentor.cx@gmail.com)
[](https://www.linkedin.com/in/hassan-faraji-b975b2aa/)
### Developer
**Mohammad Mohagheghian**
[](mailto:vito.mohagheghian@gmail.com)
[](https://www.linkedin.com/in/mohammad-mohagheghian/)
[](https://mghn.info)
---
## License
[MIT](LICENSE) © 2026 Mohammad & Hassan