Aide is a local-first desktop agent for people who live inside a dozen work systems at once.
Your work is scattered across email, Teams, GitHub, meetings, and work items — and no single place shows you the whole picture. Most AI tools forget everything the moment a chat ends, so you spend five minutes setting up context for two minutes of help. And at day's end, there's no record of what you actually did.
Aide closes that gap — it sees your work whole, remembers it, and acts on it the way you would.
One place to manage all your work. An agent that already knows your context, works while you're away, and reaches you wherever you are.
Three things, working as one:
| Aggregate | Pulls your tasks from every system — email, Teams, GitHub, meetings — into one prioritized view. Nothing slips through, and you stop tab-hopping. |
| Understand | Builds a lasting memory of your projects, people, and preferences. The more you work, the less you re-explain. |
| Act | Drafts, replies, reviews, and ships — through each tool's API, and by driving a browser when there's no API. It always asks before anything leaves your hands. |
It runs proactively in the background, reaches you across your messengers — WeChat, Telegram, Discord, WhatsApp — and keeps getting more capable as you install new Skills.
| Time | What happens |
|---|---|
| 8:30 AM | Still on your commute. A morning briefing lands on WeChat: overnight email, Teams messages, GitHub notifications, and today's calendar, already triaged. You reply "snooze the vendor thread to Friday" — done, from your phone. |
| 9:00 AM | Open the app. The same prioritized task list is waiting. Thirty seconds to know what matters today. |
| 10:00 AM | A 30-minute Teams meeting ends. Aide pulls the action items from the notes, links them to the right project, and tags owners and deadlines — no manual capture. |
| 2:00 PM | Open a task ("fix the pagination bug"). Aide already knows the project, the code structure, and the related issue discussion. It locates the bug, proposes a fix and tests, and opens a PR. |
| 3:00 PM | "What did A conclude about that API change last week?" Aide answers straight from your email, Teams, and meeting history — no digging. |
| 6:00 PM | Aide reconciles the day: tasks you handled yourself, things resolved before a task even existed. It updates statuses, generates your daily report, and delivers it wherever you asked — the app, your messengers, or both. |
| AI chat assistants | Autonomous agents | Task managers | Automation tools | Aide | |
|---|---|---|---|---|---|
| Persistent task lifecycle | ✗ | ~ | ✓ | ✗ | ✓ |
| Learns you over time | ~ | ✓ | ✗ | ✗ | ✓ |
| Runs proactively | ✗ | ✓ | ✗ | ✓ | ✓ |
| Aggregates real work systems | ~ | ~ | ✗ | ✓ | ✓ |
| Judgment, not just rules | ✓ | ✓ | ✗ | ✗ | ✓ |
| Extends with new skills | ~ | ~ | ✗ | ✗ | ✓ |
| Reaches you off the desktop | ✗ | ~ | ✗ | ~ | ✓ |
Aide combines the memory and judgment of an agent with the persistent task lifecycle of a task manager and the proactive execution of automation — focused squarely on knowledge work, reachable wherever you are, and open-ended through installable skills.
Aide is built around a small set of entities, all maintainable two ways: by the agent (from conversation or by discovering things in your information flow) and by you (directly in the UI).
- Task — the central entity. Everything revolves around it. Sourced from connections, scheduled jobs, or conversation.
- Connection (Source) — an external work system (Outlook, Teams, GitHub, Calendar, SharePoint…) that Aide reads work from and acts through.
- Channel — how Aide reaches you outside the app: the built-in Aide chat plus WeChat, Telegram, Discord, and WhatsApp. Delivers briefings and reports, and takes commands remotely.
- Project — a work project (repo, docs, wiki) that gives the agent background when handling tasks.
- Skill — an extensible capability unit, peer to MCP tools. Lets Aide's abilities be installed, published, and composed instead of hard-coded.
- Job — scheduled automation (morning aggregation, periodic polling, end-of-day reconciliation), with per-job control over which Channels receive its result.
- Memory — the agent's growing understanding of you: preferences, decisions, project progress, and people. Viewable, correctable, and deletable.
flowchart LR
J[Job scheduler] -->|polls| C[Connections / Sources]
C -->|raw data| A[Agent]
U[You] -->|chat| A
A -->|creates / updates| T[Task]
A -. reads .-> P[Project]
A -. reads .-> M[Memory]
A -. loads .-> S[Skill]
A -->|acts via| C
A -->|delivers results| CH[Channels]
CH -->|remote commands| A
CH --> U
T -->|distills into| M
The quickest way to try Aide — no toolchain required.
- Download the installer for your platform from the Releases page.
- Run it and launch Aide.
- Connect your accounts from Settings → Connections.
Aide reaches your work systems through two MCP servers:
- Microsoft 365 via
@microsoft/workiq— Outlook, Teams, Calendar, SharePoint/OneDrive, and People in one server. - GitHub via the GitHub MCP Server — issues, PRs, repos, and notifications.
See docs/connection.md for setup details, including the Work IQ flag and admin-consent notes.
Run from source
Prerequisites: Node.js 20+ and npm.
npm install # install dependencies
npm run dev # run in development (hot reload)
npm run build # build for production
npm run preview # preview the production buildAide is a single local-first Electron app — your data stays on your machine. The main process hosts the agent, scheduler, connections, and storage; work systems connect through MCP servers, and capabilities extend through installable Skills. Memory is a three-layer design on local SQLite, no ML dependencies.
Architecture & tech stack
The main process hosts the agent (GitHub Copilot SDK), job scheduler, connections, and storage; the renderer delivers the task-list + chat workspace over typed IPC. Work systems connect through MCP servers (@microsoft/workiq for M365, the GitHub MCP Server, plus user-installed MCP), and capabilities extend through Skills (built-in / community / local). Memory is a three-layer design — L0 identity, L1 knowledge, L2 archive — on SQLite FTS5 with structured tags.
| Decision | Choice | Why |
|---|---|---|
| Product form | Local desktop app (Electron) | Personal tool, sensitive data, local-first |
| AI engine | GitHub Copilot SDK | Reasoning loop, tool orchestration, session persistence out of the box |
| External connections | MCP protocol | Standard tool/resource protocol with the largest ecosystem |
| Storage | Local SQLite + filesystem | No server needed; easy to migrate and back up |
| Language | TypeScript everywhere | One language across Electron, Copilot SDK, and MCP |
| UI | React 19 · Zustand · Tailwind CSS | Lightweight, fast to iterate |
See docs/architecture.md and docs/memory.md for the full design.
| Doc | What it covers |
|---|---|
| PRODUCT.md | Product definition, target user, positioning, roadmap |
| docs/architecture.md | System architecture, process model, storage |
| docs/agent.md | Agent engine: prompt assembly, tools, autonomy levels |
| docs/memory.md | Three-layer memory system |
| docs/task.md | Task entity, state machine, dedup, prioritization |
| docs/connection.md | External connections (Work IQ + GitHub) |
| docs/project.md | Project context |
| docs/skill.md | Skill extensibility model |
| docs/job.md | Scheduling subsystem |
| docs/ui.md | UI design and interaction flows |
| Troubleshooting | DevTools, diagnostics panel, common issues |
Aide is in early access: the core experience is in place, while the agent-driven collection and execution paths continue to be hardened. See PRODUCT.md for the full scope and what's next.
Open Chrome DevTools in the installed app to view console logs and debug issues:
- Keyboard shortcut: Press
Ctrl+Shift+I(Windows/Linux) orCmd+Shift+I(Mac) - From UI: Go to Settings → Connections, scroll to the Troubleshooting section, and click DevTools
If a connection fails, the Troubleshooting section in Settings → Connections shows:
- Platform, architecture, and app version
- Whether the bundled Node.js runtime is present
- The npx command being used
- Connection status for each source (Microsoft 365, GitHub)
Click Show Diagnostics to reveal this panel.
Click Open Logs Folder in the Troubleshooting section to open the app's user data directory. Console output and error logs are stored there.
| Problem | Possible cause | Solution |
|---|---|---|
| "Authentication failed" on M365 | OAuth flow interrupted or permissions denied | Try again; ensure you complete the browser sign-in |
| "Could not start workiq CLI" | Bundled Node.js runtime missing | Check diagnostics — bundledNpxExists should be ✓ |
| MCP server fails to start | Missing Teams/M365 admin permissions | Ask your tenant admin to grant the required Graph API scopes |
| GitHub not connecting | gh CLI not installed |
Install via winget install GitHub.cli or cli.github.com |
Private project. All rights reserved.