claudeers.
// Developer Tools

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.

// Developer Tools[ cli ][ api ][ desktop ][ web ][ claude ]#claude#accessibility#agent-ui#ai-agents#antigravity#chatgpt#claude-code#codex#devtools◷ MIT$open-sourceupdated 2 days ago

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.
// or clone
git clone https://github.com/Phz-06/agent-frontdesk

// compatibility

Platformscli, api, desktop, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageTypeScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗
Agent Frontdesk logo

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 · 简体中文

A rail of AI avatars on the left with what each one just said, projects and chats in the middle, and a running conversation on the right A Codex chat with the README its reply mentions opened in the preview on the right
Several AIs at work, each with its latest line next to its avatarA 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
AIReads history fromSends through
CodexCodex's local app-serverCodex's own message queue and its window-to-window channel (also for model changes), with macOS Accessibility / Windows UIA for new chats
ClaudeClaude Code's session transcriptsmacOS Accessibility / Windows UIA
AntigravityIts local database and transcriptsIts 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
VariablePurposeDefault
HOST / PORTAddress the server listens on127.0.0.1 / 4100
HTTPS_PORTHTTPS port with a self-signed certificate, for the microphone on other devices; 0 turns it offPORT + 1 when HOST is not local
BRIDGE_DEFAULT_CWDWorking folder for new chatsyour home folder
BRIDGE_UPLOADS_DIRWhere attachments are storeduploads/ in the project
BRIDGE_EXPORTS_DIRWhere 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_FILEWhere it keeps which AIs are on, their names and order.frontdesk.json in the project
BRIDGE_PLUGIN_DIRFolder the plugins are loaded fromdist/server/plugins
BRIDGE_MODEL_CATALOGJSON file of model IDs for AIs that cannot list their ownnone
BRIDGE_DICTATION_ENGINEWhich AI's speech-to-text voice input tries first; it falls back to another AI's or the browser'sclaude
CODEX_BIN / CODEX_HOMECodex executable and data folderfound on PATH, ChatGPT.app / MSIX package / ~/.codex
CLAUDE_BIN / CLAUDE_HOMEClaude Code executable and session folderfound on PATH or in Claude's app data / ~/.claude
CLAUDE_DESKTOP_HOMEClaude desktop app's data folder~/Library/Application Support/Claude (Windows: %LOCALAPPDATA%\Claude-Data\claude_<id>, else %APPDATA%\Claude)
AGENTAPI_BIN / ANTIGRAVITY_HOMEAntigravity's CLI and data folder~/.gemini/antigravity
CHATGPT_APP_ASAR / CLAUDE_APP_ASAR / ANTIGRAVITY_APP_ICONInstalled 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.

1 views
★ 14 stars
unclaimed
updated 2 days ago

// embed badge

agent-frontdesk on Claudeers
[![Claudeers](https://claudeers.com/api/badge/agent-frontdesk.svg)](https://claudeers.com/agent-frontdesk)

// retro hit counter

agent-frontdesk hit counter
[![Hits](https://claudeers.com/api/counter/agent-frontdesk.svg)](https://claudeers.com/agent-frontdesk)

// reviews

// guestbook

0/500

// related in Developer Tools

🔓

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Curs…

// devtoolsaffaan-m/⟨JavaScript⟩★ 307,864◷ MIT[ claude ]
🔓

Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.

// devtoolsDietrichGebert/⟨JavaScript⟩★ 187,728◷ MIT[ claude ]
🔓

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,…

// devtoolssafishamsi/⟨Python⟩★ 147,800◷ MIT[ claude ]
🔓

Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA

// devtoolsgarrytan/⟨TypeScript⟩★ 140,465◷ MIT[ claude ]
→ see how agent-frontdesk connects across the ecosystem