https://github.com/azayrahmad/ms-agent-js
Microsoft Agent reimplementation for the web in TypeScript. Make Clippy and friends your assistants!
https://github.com/azayrahmad/ms-agent-js
agent-ui clippy llm-ui microsoft-agent ms-agent ms-office-2000 nostalgia office-2000 office-assistant typescript windows-98
Last synced: 2 months ago
JSON representation
Microsoft Agent reimplementation for the web in TypeScript. Make Clippy and friends your assistants!
- Host: GitHub
- URL: https://github.com/azayrahmad/ms-agent-js
- Owner: azayrahmad
- License: mit
- Created: 2026-03-12T07:22:37.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-04T16:08:03.000Z (3 months ago)
- Last Synced: 2026-04-04T18:24:30.943Z (2 months ago)
- Topics: agent-ui, clippy, llm-ui, microsoft-agent, ms-agent, ms-office-2000, nostalgia, office-2000, office-assistant, typescript, windows-98
- Language: HTML
- Homepage: https://azayrahmad.github.io/ms-agent-js/
- Size: 12.3 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
MSAgentJS: The Modern Clippy for the Web
A web reimplementation of Microsoft Agent. Bring back Clippy and other classic Office assistants with authentic animations and speech support. Perfect for retro UIs and nostalgic web projects.
Inspired by [clippy.js](https://github.com/clippyjs/clippy.js), this is a fully rewritten project focuses on a more faithful and modern recreation of Microsoft Agent with improved animation handling, richer features, extensibility, and a design that works seamlessly on any web page.
Live Demo |
Documentation |
Contributing |
Support on Ko-Fi
## ✨ Features
- **Interactive**: Agents are draggable and clickable (single, double, and right-click) with events.
- **Speech Support**: Support interactive speech balloon text input, selection list, checkbox, and buttons in authentic speech balloon.
- **TTS Support**: TTS support with browser's native Web Speech API.
- **Zero Dependencies**: No jQuery or any other external libraries required to run.
- **Modern API**: Simple, promise-based API for animations, state transitions, and speech.
- **Zero CSS leakage**: Shadow DOM isolates the Agent, making it safe to drop into any project.
- **High Performance**: Uses HTML5 Canvas and optimized asset formats (WebP/WebM).
- **Legacy Support**: Works with decompiled MS Agent's ACF files directly. Add your own Agents!
## 🎭 Available Agents
Current iteration of MSAgentJS focuses on recreating early Microsoft Agent 2.0 featured in Office 2000. Support for 2.1 version such as Genie and Merlin is in the works.
| Clippit | The Dot | F1 | The Genius | Office Logo | Mother Nature | Monkey King | Links | Rocky |
| :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: |
|  |  |  |  |  |  |  |  |  |
## 📦 Installation
```bash
npm install ms-agent-js
```
You can also download the pre-built library and assets directly from [GitHub Releases](https://github.com/azayrahmad/ms-agent-js/releases).
## 🛠 Quick Start
```javascript
import { Agent } from 'ms-agent-js';
async function init() {
const agent = await Agent.load('Clippit');
await agent.show();
await agent.speak('Hello! I am your web assistant.');
}
init();
```
---
## 📖 Documentation
- **[Getting Started](./docs/getting-started.md)**: Installation and basic usage.
- **[API Reference](./docs/api-reference.md)**: Full list of methods, options, and events.
- **[Request System](./docs/request-system.md)**: Understanding the asynchronous action queue.
- **[Asset Management](./docs/assets.md)**: How to add and optimize new agents.
- **[Demo Implementation](./docs/demo-guide.md)**: A guide to how the demo is built.
- **[Internal Architecture](./docs/internals.md)**: Deep dive into the engine's core logic.
- **[AI Onboarding](./AGENTS.md)**: Specific recipes and tips for AI agents.
- **[Contributing](./CONTRIBUTING.md)**: Guidelines for developers and repo setup.
## 🛣️ Future Roadmap
- Support for MS Agent 2.1 features:
- Advanced animation looping logic.
- Mouth movement (viseme).
- Tray icon.
- Support for streaming text (for LLM streaming output)
## 🤝 Credits
- The original [Microsoft Agent](https://learn.microsoft.com/en-us/windows/win32/lwef/microsoft-agent) for Microsoft Office 2000 by Microsoft Corporation.
- Reimplementations and decompilers, including [Double Agent](https://doubleagent.sourceforge.net/), [MSAgent Decompiler by Remy Lebeau](http://www.lebeausoftware.org/software/decompile.aspx), and more recently [TripleAgent](https://github.com/calavera42/TripleAgent) by [calavera](https://github.com/calavera42).
- The first JavaScript implementation who started it all, [clippy.js](https://github.com/clippyjs/clippy.js) by [smore](https://github.com/smore-inc), and some great forks like [ClippyJS_EasyAccess](https://github.com/djbritt/ClippyJS_EasyAccess) by [Daniel Britt](https://github.com/djbritt) and [Clippy](https://github.com/pi0/clippy) by [Pooya Parsa](https://github.com/pi0).
- The demo page is styled using [98.css](https://jdan.github.io/98.css/) by [Jordan Scales](https://jordanscales.com/).
- [TMAFE](https://tmafe.com/), the Microsoft Agent community that provides many Agent files and information.
## ⚖️ License
[MIT License](./LICENSE).