
agent-frontdesk
One web page for every desktop AI on your computer. Send a new AI one prompt and it connects itself. Works with Codex, Claude and Antigravity today.
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up agent-frontdesk (git-clone project) into my current project. Found on https://claudeers.com/agent-frontdesk Repo: https://github.com/Phz-06/agent-frontdesk Homepage/docs: — Detected install method: git-clone → git clone https://github.com/Phz-06/agent-frontdesk Category: devtools. Platforms: cli, api, desktop, web. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: unknown; community-verified: false. Confirm the source before running anything.
git clone https://github.com/Phz-06/agent-frontdesk
// compatibility
| Platforms | cli, api, desktop, web |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | TypeScript |
Agent Frontdesk
One web page for every desktop AI on your computer.
To add a new one, send it a prompt and it connects itself.
Quick start · Add an AI · How it works · Roadmap · 简体中文
|
|
| Several AIs at work, each with its latest line next to its avatar | A file from a reply opens in the preview on the right, and the desktop app is one click away |
Why
We subscribe to several AIs, and each one has its own desktop app. Working with them meant switching between windows all day and trying to remember which one was running and how far it had got.
Agent Frontdesk puts those desktop apps into one web page. The apps still do the work, on your own account and subscription. The page only carries your messages over and brings the progress back. Both sides are the same session, so you can go back to the desktop app and carry on at any time.
Features
- All your AIs sit in a rail on the left. You can see who is running, who has a new reply and how much quota is left, and each one's latest line pops up next to its avatar
- The sidebar has each AI's projects and chats, grouped the way its desktop app groups them, with search and a list of recent chats
- Continue any chat, or start a new one in a project
- Send, steer a running turn, queue, stop. Switching to another AI while one is running does not interrupt it
- Change the model, reasoning effort and permissions, attach images and files, dictate
- Refer to another AI's chat: Frontdesk attaches that chat to your message as a card you can also turn into text to edit, with the older turns of a long chat shortened
- Answer the AI's questions and approval requests right in the page
- Replies look the way each desktop app shows them, with code, maths, diagrams, tool steps and plans
- A file mentioned in a reply opens in a preview on the right with one click, or shows in Finder / File Explorer
- Any chat opens in its desktop app with one click, on the same session
- Switch AIs on and off, rename them, reorder them, change their avatars. Light and dark, English and Chinese
Quick start
You need macOS or Windows 11 and Node.js 22.16 or later. Nothing else is installed: the helper that works the desktop apps' windows is compiled on your machine, with Xcode's command line tools on macOS and with the C# compiler that ships with Windows (.NET Framework 4) on Windows.
git clone https://github.com/Phz-06/agent-frontdesk.git
cd agent-frontdesk
npm ci
npm start
Open http://127.0.0.1:4100. Every AI whose desktop app is installed shows up in the rail, and you can switch them on and off under +.
Codex, Claude and Antigravity are connected so far. Open the desktop app and sign in before you use one.
On macOS, sending to Codex and Claude needs the Accessibility permission. In System Settings → Privacy & Security → Accessibility, allow the terminal app you run npm start in, then start Frontdesk again. On Windows 11 there is no permission to grant; run Frontdesk with the same rights as the desktop apps (both as administrator, or neither), since Windows lets a program read a window of a higher-rights app but not act on it. For now, keep the desktop apps' interface in English.
Claude's model list, quota and voice input also need Claude Code signed in once, with the account the desktop app uses. When it is not, the page shows the command to run in a terminal.
If the port is taken, run PORT=4200 npm start (or in Windows PowerShell: $env:PORT=4200; npm start).
What to expect on Windows
On macOS, Frontdesk presses buttons in a desktop app's window without that window taking the keyboard. Windows doesn't allow it: whenever Frontdesk fills in a message or presses Send in Claude's or Codex's window, that window takes the keyboard focus for a moment. We keep that moment short and put everything back afterwards, but you may still notice it:
- Typing elsewhere while a message goes out. One message takes the focus 2–3 times, 20–90 ms each. Frontdesk waits for a pause when you type in its own page, but in other apps a word you're composing with an input method can be cut off, or a key lost.
- Changing the model or effort. The app's menu only works while the app has the focus, so for about half a second your keystrokes go to the app.
- Full screen. If the program in front runs in exclusive full screen, Frontdesk holds the message until you leave it. A borderless full-screen window may stutter for a moment.
- A few pixels in a corner. While it works, the app's window sits off screen except for a corner, and goes back where it was afterwards. If the server stops halfway, the next start puts it back.
- Codex's regular messages, steers, stops and most model changes use its own channel and aren't affected. A new Codex chat, and a model change for a chat Codex has not opened yet, go through its window like Claude's.
If you know a way to act on a Chromium/Electron window on Windows without it taking the focus, please get in touch. What we've tried and measured is in docs/windows.md.
Add an AI
Frontdesk is meant for every desktop AI, so connecting one is a job for the AI itself. Click + in the rail, copy the prompt and send it to the AI you want to add. It follows the onboarding guide and writes its own plugin: it reads its own data, picks a channel for sending, and declares what it can do.
It does not build any pages. The sidebar, conversation, composer, cards, file preview, queue and quota are shared, and a new AI gets them all. Everything a plugin implements is in one file, src/shared/contract.ts.
How it works
Frontdesk is a small server on your computer. It reads the records each desktop app keeps locally to show history and progress. To send, it uses the app's own channel: an interface where the app has one, and otherwise macOS Accessibility (or Windows UI Automation on Windows 11), which fills in the message and presses Send in the app's window in the background, without bringing it to the front. On Windows the app's window takes the keyboard focus for a moment each time; Frontdesk gives it straight back and puts the window back where it was (see What to expect on Windows). No key is sent and the clipboard is never touched.
Browser ──▶ Frontdesk server ──▶ a plugin per AI ──▶ the desktop app
◀── the app's local records
| AI | Reads history from | Sends through |
|---|---|---|
| Codex | Codex's local app-server | Codex's own message queue and its window-to-window channel (also for model changes), with macOS Accessibility / Windows UIA for new chats |
| Claude | Claude Code's session transcripts | macOS Accessibility / Windows UIA |
| Antigravity | Its local database and transcripts | Its local language server |
Whether a turn has finished is decided by the desktop app's own record. These channels can change when a desktop app updates, and we update with them.
More detail is in docs/architecture.md.
Configuration
All optional. Frontdesk finds standard install locations by itself.
Environment variables
| Variable | Purpose | Default |
|---|---|---|
HOST / PORT | Address the server listens on | 127.0.0.1 / 4100 |
HTTPS_PORT | HTTPS port with a self-signed certificate, for the microphone on other devices; 0 turns it off | PORT + 1 when HOST is not local |
BRIDGE_DEFAULT_CWD | Working folder for new chats | your home folder |
BRIDGE_UPLOADS_DIR | Where attachments are stored | uploads/ in the project |
BRIDGE_EXPORTS_DIR | Where the whole record of a long chat you refer to is written as Markdown, when the message carries it shortened (kept 30 days) | exports/ in the project |
BRIDGE_SETTINGS_FILE | Where it keeps which AIs are on, their names and order | .frontdesk.json in the project |
BRIDGE_PLUGIN_DIR | Folder the plugins are loaded from | dist/server/plugins |
BRIDGE_MODEL_CATALOG | JSON file of model IDs for AIs that cannot list their own | none |
BRIDGE_DICTATION_ENGINE | Which AI's speech-to-text voice input tries first; it falls back to another AI's or the browser's | claude |
CODEX_BIN / CODEX_HOME | Codex executable and data folder | found on PATH, ChatGPT.app / MSIX package / ~/.codex |
CLAUDE_BIN / CLAUDE_HOME | Claude Code executable and session folder | found on PATH or in Claude's app data / ~/.claude |
CLAUDE_DESKTOP_HOME | Claude desktop app's data folder | ~/Library/Application Support/Claude (Windows: %LOCALAPPDATA%\Claude-Data\claude_<id>, else %APPDATA%\Claude) |
AGENTAPI_BIN / ANTIGRAVITY_HOME | Antigravity's CLI and data folder | ~/.gemini/antigravity |
CHATGPT_APP_ASAR / CLAUDE_APP_ASAR / ANTIGRAVITY_APP_ICON | Installed apps that icons, characters and fonts are read from | /Applications on macOS, %LOCALAPPDATA%\Programs or MSIX on Windows |
Security and privacy
- The server listens on your own machine only and has no login, so do not expose it to the internet
- Chats stay on your computer. There is no telemetry and no server of ours
- Voice input and quota use Claude Code's own sign-in, read on the server only
- On macOS, the Accessibility permission goes to the terminal that runs Frontdesk (Windows uses UI Automation with no system-wide Accessibility grant)
To report a vulnerability, see SECURITY.md.
Roadmap
- More desktop AIs
- Full support for desktop apps set to Chinese and other interface languages
- A login, so you can check in and send from your phone
Development
npm run dev # page with hot reload on PORT, server on PORT+1
npm test
npm run check # type check and build
Issues and pull requests are welcome. See CONTRIBUTING.md.
License
MIT. Agent Frontdesk is an independent project, not affiliated with OpenAI, Anthropic or Google. Product names are trademarks of their owners.
// faq
What is agent-frontdesk?
One web page for every desktop AI on your computer. Send a new AI one prompt and it connects itself. Works with Codex, Claude and Antigravity today.. It is open-source on GitHub.
Is agent-frontdesk free to use?
agent-frontdesk is open-source under the MIT license, so it is free to use.
What category does agent-frontdesk belong to?
agent-frontdesk is listed under devtools in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/agent-frontdesk)
// retro hit counter
[](https://claudeers.com/agent-frontdesk)
// reviews
// guestbook
// related in Developer Tools
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Curs…
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…
Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA