agent-frontdesk

agent
Security Audit
Warn
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 13 GitHub stars
Code Warn
  • network request — Outbound network request in src/client/js/api.ts
  • network request — Outbound network request in src/client/js/dictation.ts
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

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.

README.md
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.

CI
License: MIT
Platform: macOS
Node 22.16+
PRs welcome

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 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
  • 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
  • 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 and Node.js 22.16 or later.

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.

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. 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.

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 the macOS Accessibility API, which fills in the message and presses Send in the app's window in the background, without bringing it to the front.

 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 for new chats
Claude Claude Code's session transcripts macOS Accessibility
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_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 or in ChatGPT.app / ~/.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
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 under /Applications

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
  • The Accessibility permission goes to the terminal that runs Frontdesk

To report a vulnerability, see SECURITY.md.

Roadmap

  • Windows support
  • 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.

Reviews (0)

No results found