Retour aux skills
desktop-assistant
par jrubiosainz
Copilot—Pas encore noté
Ta note
Résumé
Desktop Assistant built with GitHub Copilot SDK - AI-powered Windows control with 44 custom tools
Description
# Desktop Assistant
A powerful desktop assistant application built with the **GitHub Copilot SDK** and **Electron**. This app provides a chat interface to interact with GitHub Copilot, enhanced with 60+ custom tools for Windows system control and Microsoft 365 integration.
---
## ⚡ <span style="color: gold; font-size: 1.5em;">🟡 NEW Release — 11th Feb 2026!!</span>
> **🟡 Major update with 30+ new features and capabilities!**
### 🆕 What's New in This Release:
**🗓️ Teams Meetings & Calendar**
- **Create Teams Meetings** — Full meeting invitations with Teams link, attendees, duration, importance, and auto-send
- **Create Calendar Events** — Personal appointments with all-day support, reminders, and custom location
- **Cancel Meetings** — Search and cancel meetings by subject/date with automatic attendee notification
**🟢 Teams Presence Control**
- **Set Teams Status** — Change your presence to Available, Busy, Do Not Disturb, Be Right Back, Away, or Offline via Microsoft Graph API
- **Get Teams Status** — Query your current Teams presence and status message
- **Custom Status Messages** — Set a custom status message with optional auto-expiration timer
**🖼️ Image Attachments in Chat**
- **Inline image preview** — Attached images now display directly inside chat message bubbles
- **Full-size image overlay** — Click any chat image to view it at full resolution
- **Drag & drop support** — Drop image files onto the chat area to attach them
- **Paste from clipboard** — Ctrl+V to paste images directly from clipboard
- **Screenshot capture** — Capture your screen and attach it to a message with one click
**🤖 Updated AI Models**
- **19 models available** including GPT-5, GPT-5.1, GPT-5.2, GPT-5.1 Codex/Codex-Max, Claude Opus 4.5/4.6, Claude Sonnet 4/4.5, Gemini 2.5 Pro, Gemini 3 Flash/Pro, and more
- **Live model switching** — Change models on the fly without restarting
- **Reasoning effort selector** — Low/Medium/High reasoning for O1/O3/GPT-5 models
**🎤 Voice Input (Azure AI Whisper)**
- **Speech-to-text** via Azure AI Foundry Whisper with Entra ID authentication (no API key needed)
- **One-click recording** with animated indicator and auto-send
- **In-app setup wizard** and microphone test
**🎨 Theme & UI Enhancements**
- **Dark / Light / System theme toggle** with persistence across sessions
- **Chat history panel** — Browse, restore, and delete past conversations (persisted to disk)
- **Slash commands** — Quick actions: `/meetings`, `/emails`, `/system`, `/screenshot`, `/windows`, `/apps`, `/files`, `/clipboard`, `/help` with auto-complete suggestions
- **Streaming responses** — Real-time incremental rendering with markdown support
- **Tool execution indicators** — Visual spinner with tool name during execution, checkmark on completion
- **User confirmation dialogs** — Modal prompts for dangerous operations
**⌨️ Keyboard Shortcuts & System Tray**
- `Ctrl+Shift+Space` — Global activate from anywhere
- `Ctrl+Shift+N` — New chat
- `Ctrl+H` — Toggle history
- `Ctrl+,` — Open settings
- **System tray** with quick commands menu (Meetings, Emails, System Info, Screenshot)
**🔄 Session Resilience**
- Automatic session retry with escalating recovery (new session → full client restart)
- Lazy session creation and reconnection on the fly
---
## 🆕 Work IQ — Microsoft 365 Integration



Learn more:
- [Bringing work context to your code in GitHub Copilot](https://developer.microsoft.com/blog/bringing-work-context-to-your-code-in-github-copilot)
- [Work IQ MCP Repository](https://github.com/microsoft/work-iq-mcp)
---




## Features
### 💼 Work IQ — Microsoft 365 Integration
Query your Microsoft 365 data with natural language powered by [Work IQ MCP](https://github.com/microsoft/work-iq-mcp):
- **📅 Meetings** — "What meetings do I have today?" / "Tell me about my 1:1 with manager"
- **📧 Emails** — "Show me emails from my manager" / "Summarize emails about the budget"
- **📄 Documents** — "Find my recent PowerPoint presentations" / "Documents I edited yesterday"
- **💬 Teams** — "Summarize today's messages in the Engineering channel"
- **👥 People** — "Who is working on Project Alpha?" / "Find John Smith"
- **📊 Work Summary** — "Give me a summary of my work activity this week"
### 🗓️ Teams Meetings & Calendar
- Create Teams meeting invitations with online link and attendees
- Create personal calendar events
- Cancel meetings with attendee notification
- Set and get your Teams presence status
- Custom status messages with auto-expiration
### 🪟 Window Management
- List all open windows
- Focus, minimize, maximize, restore windows
- Close windows by name
### 📁 File Management
- List directory contents
- Search for files by pattern
- Create, move, copy, delete, rename files and folders
- Read file contents
### 🚀 Application Management
- List installed applications
- List running applications
- Launch applications by name
- Quit/close applications
### ⚙️ System Controls
- Get/set system volume
- Mute/unmute audio
- Take screenshots
- Get system information (OS, CPU, memory, disk)
### 📊 Process Management
- List running processes with resource usage
- Kill processes by name or PID
- Get detailed process information
### 📋 Clipboard
- Read clipboard contents
- Write text to clipboard
### 📄 Microsoft Office Integration
- Create Word documents
- Create Excel spreadsheets
- Create PowerPoint presentations
- Create Outlook emails
- Open any Office document
### 🖼️ Image & Vision
- Capture screenshots and attach to chat
- Drag & drop or paste images
- Inline image display in chat with full-size overlay
- Vision-capable model support (GPT-4.1, GPT-5, Claude Opus, etc.)
### 🎤 Voice Input
- Azure AI Whisper speech-to-text
- Entra ID authentication (no API key)
- One-click recording with auto-send
### 🎨 Themes & UI
- Dark / Light / System theme toggle
- Chat history panel with session restore
- Slash commands with auto-complete
- Streaming responses with markdown
- Tool execution indicators
- User confirmation dialogs
- Keyboard shortcuts
## Prerequisites
- **Node.js** 18+
- **npm** or **yarn**
- **GitHub Copilot CLI** installed and authenticated
- **Windows 10/11** (tools are Windows-specific)
- **Work IQ** (optional, for M365 integration): `npm install -g @microsoft/workiq`
- **Azure CLI** (optional, for Teams status & voice input): `az login`
## Installation
1. Clone the repository:
```bash
git clone https://github.com/jrubiosainz/desktop-assistant.git
cd desktop-assistant
```
2. Install dependencies:
```bash
npm install
```
3. Authenticate with GitHub Copilot CLI:
```bash
copilot
# Then type /login and follow the prompts
```
4. (Optional) Set up Work IQ for Microsoft 365 integration:
```bash
# Install globally
npm install -g @microsoft/workiq
# Accept the EULA
npx -y @microsoft/workiq accept-eula
# Test the connection (will prompt for Microsoft login on first use)
workiq ask -q "test"
```
5. Build and run:
```bash
npm run build
npm run electron
```
## Usage
1. Launch the app with `npm run electron`
2. Wait for the "Connected" status
3. Type natural language commands like:
- "List my open windows"
- "What files are in my Documents folder?"
- "Take a screenshot"
- "Create a Word document about project planning"
- "What's my system info?"
- "Set volume to 50%"
- "Create a Teams meeting with john@company.com tomorrow at 10am"
- "Set my Teams status to busy"
- "Cancel the meeting about project review"
### Slash Commands
Type `/` in the chat to see available quick commands:
- `/meetings` — Show today's meetings
- `/emails` — Show unread emails
- `/system` — System information
- `/screenshot` — Take a screenshot
- `/windows` — List open windows
- `/apps` — List running apps
- `/files` — List files in current directory
- `/clipboard` — Show clipboard contents
- `/help` — Show all commands
### Keyboard Shortcuts
| Shortcut | Action |
|---|---|
| `Ctrl+Shift+Space` | Global activate (from anywhere) |
| `Ctrl+Shift+N` | New chat |
| `Ctrl+H` | Toggle history panel |
| `Ctrl+,` | Open settings |
| `Enter` | Send message |
| `Shift+Enter` | New line |
| `Escape` | Cancel/abort request |
## Project Structure
```
desktop-assistant/
├── src/
│ ├── main.ts # Electron main process + Copilot SDK
│ └── tools/
│ ├── index.ts # Tool exports
│ ├── windows-tools.ts # Window management
│ ├── file-tools.ts # File operations
│ ├── app-tools.ts # Application control
│ ├── system-tools.ts # System controls
│ ├── process-tools.ts # Process management
│ ├── clipboard-tools.ts # Clipboard operations
│ ├── office-tools.ts # Microsoft Office + Teams meetings/status
│ └── workiq-tools.ts # Microsoft 365 Work IQ integration
├── renderer/
│ ├── index.html # Chat UI
│ ├── renderer.js # UI logic
│ └── styles.css # Styling (dark/light/system themes)
├── dist/ # Compiled output
├── package.json
├── tsconfig.json
└── build.mjs # esbuild configuration
```
## Development
### Build
```bash
npm run build
```
### Run in development
```bash
npm run electron
```
### Watch mode (if needed)
```bash
npm run build -- --watch
```
## Configuration
The app uses the GitHub Copilot CLI configuration at `~/.copilot/config.json`. You can add trusted folders there:
```json
{
"trusted_folders": [
"C:\\path\\to\\your\\project"
]
}
```
## Tech Stack
- **[GitHub Copilot SDK](https://www.npmjs.com/package/@github/copilot-sdk)** — AI-powered assistant
- **[Electron](https://www.electronjs.org/)** — Desktop application framework
- **[TypeScript](https://www.typescriptlang.org/)** — Type-safe JavaScript
- **[Zod](https://zod.dev/)** — Schema validation for tool parameters
- **[esbuild](https://esbuild.github.io/)** — Fast bundler
- **[Work IQ MCP](https://github.com/microsoft/work-iq-mcp)** — Microsoft 365 Copilot integration
- **[Azure Identity](https://www.npmjs.com/package/@azure/identity)** — Entra ID authentication
## License
MIT License — see [LICENSE](LICENSE) file for details.
## Acknowledgments
- Built with the [GitHub Copilot SDK](https://github.blog/changelog/2025-01-21-github-copilot-sdk-public-preview/)
- Powered by [Work IQ MCP](https://github.com/microsoft/work-iq-mcp) for Microsoft 365 integration
- Inspired by the power of AI-assisted development
Installation
Installe le skill depuis https://github.com/jrubiosainz/desktop-assistantCe skill n'est pas publié sur le registre ClawHub. Colle l'instruction dans ton agent de code — Claude Code, Cursor, Codex — et il installera le skill directement depuis le dépôt source.
Ouvrir le dépôt