Skip to content
Back to search

desktop

Agentify Desktop lets Codex/Claude/OpenCode control your logged-in ChatGPT, Claude, AiStudio, Gemini, Grok, Perplexity web sessions via MCP, parallel hidden/visible tabs, file upload + image download

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/agentify-sh--desktop/badge.svg)](/listings/agentify-sh--desktop)

HTML

<a href="/listings/agentify-sh--desktop"><img src="/api/listings/agentify-sh--desktop/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 332 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Agentify Desktop
  2. Agentify Desktop is a local control center for AI web sessions. It lets MCP-capable tools such as Codex, Claude Code, and OpenCode use the AI subscriptions you are already signed into, while keeping browser state, files, and automation on your machine.
  3. ## What It Does
  4. - Opens a local Agentify Control Center.
  5. - Manages signed-in browser sessions for ChatGPT, Claude, Perplexity, Gemini, Google AI Studio, and Grok.
  6. - Exposes MCP tools for querying a tab, reading a page, navigating, uploading files, saving artifacts, and reusing stable tab keys.
  7. - Supports parallel tabs so different agents or tasks can use separate sessions.
  8. - Packs local repo/file context into prompts when requested.
  9. - Saves generated images/files locally so they can be reused in follow-up prompts.
  10. ## Example Prompts After MCP Setup
  11. Once Agentify Desktop is running and registered with your MCP client, you can ask for workflows like:
  12. - “Use Agentify with key `repo-triage` to ask ChatGPT for a second opinion on this bug, then compare its answer with your own analysis.”
  13. - “Open a Perplexity tab with key `research-auth-flow` and research current OAuth best practices for desktop apps.”
  14. - “Send this implementation plan to Claude in a separate Agentify tab and summarize any risks it finds.”
  15. - “Use Agentify to generate three UI concept images, save the images as artifacts, and return the local file paths.”
  16. - “Open Grok and ChatGPT in separate Agentify tabs, ask both to review this API design, then compare the tradeoffs.”
  17. - “Pack this repo into context, ask ChatGPT to identify risky files, and save the conversation under a stable tab key for follow-ups.”
  18. - “Read the current ChatGPT page through Agentify and turn the conversation into actionable TODOs.”
  19. ## Requirements
  20. - Node.js 20 or newer
  21. - An MCP-capable CLI if you want tool integration: Codex, Claude Code, or OpenCode
  22. ## Supported Sites
  23. - `chatgpt.com`
  24. - `claude.ai`
  25. - `perplexity.ai`
  26. - `aistudio.google.com`
  27. - `gemini.google.com`
  28. - `grok.com`
  29. ## Preferred Install And Run
  30. Start the desktop GUI without cloning this repo:
  31. ```bash
  32. npx @agentify/desktop
  33. ```
  34. Equivalent explicit GUI command:
  35. ```bash
  36. npx @agentify/desktop gui
  37. ```
  38. If you prefer a global install:
  39. ```bash
  40. npm install -g @agentify/desktop
  41. agentify-desktop
  42. ```
  43. If you want the older repo-clone and local source workflow, use [DEVELOPMENT_FROM_SOURCE.md](DEVELOPMENT_FROM_SOURCE.md).
  44. ## MCP Server
  45. Run the MCP server over stdio:
  46. ```bash
  47. npx @agentify/desktop mcp
  48. ```
  49. Show newly-created browser tabs while debugging:
  50. ```bash
  51. npx @agentify/desktop mcp --show-tabs
  52. ```
  53. With a global install:
  54. ```bash
  55. agentify-desktop-mcp
  56. agentify-desktop-mcp --show-tabs
  57. ```
  58. ## Register With MCP Clients
  59. Codex:
  60. ```bash
  61. codex mcp add agentify-desktop -- npx -y @agentify/desktop mcp
  62. ```
  63. Claude Code:
  64. ```bash
  65. claude mcp add --transport stdio agentify-desktop -- npx -y @agentify/desktop mcp
  66. ```
  67. OpenCode config example:
  68. ```json
  69. {
  70. "mcp": {
  71. "agentify-desktop": {
  72. "type": "local",
  73. "command": ["npx", "-y", "@agentify/desktop", "mcp"],
  74. "enabled": true
  75. }
  76. }
  77. }
  78. ```
  79. Use `--show-tabs` at the end of the command while debugging:
  80. ```bash
  81. codex mcp add agentify-desktop -- npx -y @agentify/desktop mcp --show-tabs
  82. ```
  83. ## First Run
  84. 1. Start the app:
  85. ```bash
  86. npx @agentify/desktop
  87. ```
  88. 2. In the Control Center, create or show a ChatGPT tab.
  89. 3. Sign in to the target vendor in the browser window.
  90. 4. Register the MCP server with your CLI.
  91. 5. Ask your MCP client to use Agentify:
  92. ```text
  93. Use Agentify Desktop with tab key repo-triage.
  94. Ask ChatGPT to summarize this repo in 8 bullets and list the top 3 risky areas to change first.
  95. Return the answer and keep the tab key stable for follow-ups.
  96. ```
  97. The core loop is:
  98. - keep a real signed-in browser session open locally
  99. - call it from an MCP client
  100. - reuse a stable tab key across follow-up prompts
  101. ## Useful MCP Tools
  102. The MCP server registers `agentify_*` tools, including:
  103. - `agentify_query`: send a prompt to a stable tab and return the assistant response.
  104. - `agentify_read_page`: read visible page text from a tab.
  105. - `agentify_navigate`: navigate a tab to a URL.
  106. - `agentify_ensure_ready`: wait for login, CAPTCHA, or UI readiness.
  107. - `agentify_show` / `agentify_hide`: bring windows forward or minimize them.
  108. - `agentify_status`: inspect tab and readiness state.
  109. - `agentify_tabs`, `agentify_tab_create`, `agentify_tab_close`: manage tabs.
  110. - `agentify_save_artifacts`, `agentify_list_artifacts`, `agentify_open_artifacts_folder`: manage generated files/images.
  111. - `agentify_save_bundle`, `agentify_list_bundles`: save and reuse context bundles.
  112. - `agentify_add_watch_folder`, `agentify_list_watch_folders`, `agentify_remove_watch_folder`: manage watched folders.
  113. ## Artifact Workflow
  114. Generate an image or file in a stable tab:
  115. ```json
  116. {
  117. "tool": "agentify_query",
  118. "arguments": {
  119. "key": "ui-concepts",
  120. "prompt": "Generate 3 clean UI concept images for a compact desktop developer tool. Keep backgrounds neutral and avoid text."
  121. }
  122. }
  123. ```
  124. Save the generated images locally:
  125. ```json
  126. {
  127. "tool": "agentify_save_artifacts",
  128. "arguments": {
  129. "key": "ui-concepts",
  130. "mode": "images",
  131. "maxImages": 3
  132. }
  133. }
  134. ```
  135. Reattach one of the returned file paths in a follow-up:
  136. ```json
  137. {
  138. "tool": "agentify_query",
  139. "arguments": {
  140. "key": "ui-concepts",
  141. "prompt": "Use the attached concept image and create a more minimal variant with stronger contrast.",
  142. "attachments": ["/absolute/path/to/concept.png"]
  143. }
  144. }
  145. ```
  146. ## Codebase Context Workflow
  147. Ask Agentify to pack local files or folders into a prompt:
  148. ```json
  149. {
  150. "tool": "agentify_query",
  151. "arguments": {
  152. "key": "repo-review",
  153. "prompt": "Summarize this codebase in 8 bullets and list the top 3 risky files to change first.",
  154. "contextPaths": ["/absolute/path/to/repo"]
  155. }
  156. }
  157. ```
  158. Control context size:
  159. ```json
  160. {
  161. "tool": "agentify_query",
  162. "arguments": {
  163. "key": "repo-review",
  164. "prompt": "Focus only on rendering and state management.",
  165. "contextPaths": ["/absolute/path/to/repo"],
  166. "maxContextChars": 120000,
  167. "maxContextFiles": 80,
  168. "maxContextInlineFiles": 30
  169. }
  170. }
  171. ```
  172. The tool result includes `packedContextSummary` so you can see what was included, attached, or skipped.
  173. ## Browser Backend
  174. Agentify Desktop supports two browser backends:
  175. - `chrome-cdp`: launches or attaches to a Chrome-family browser over Chrome DevTools Protocol. This is the default and recommended backend.
  176. - `electron`: embedded windows managed by Agentify Desktop. Use this only as an explicit fallback.
  177. Chrome CDP is the default because SSO providers commonly block embedded Electron login:
  178. ```bash
  179. npx @agentify/desktop
  180. ```
  181. Optional Chrome CDP settings:
  182. ```bash
  183. AGENTIFY_DESKTOP_CHROME_DEBUG_PORT=9333 npx @agentify/desktop
  184. AGENTIFY_DESKTOP_CHROME_BIN="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" npx @agentify/desktop
  185. ```
  186. You can also pass GUI flags:
  187. ```bash
  188. npx @agentify/desktop gui --browser-backend chrome-cdp
  189. npx @agentify/desktop gui --browser-backend electron
  190. npx @agentify/desktop gui --chrome-debug-port 9333
  191. ```
  192. Chrome CDP profile modes:
  193. - `Agentify isolated profile`: safest default.
  194. - `Existing Chrome profile`: reuses your normal Chrome session. Fully quit Chrome first so the profile is not already locked.
  195. ## CAPTCHA And Login Policy
  196. Agentify Desktop does not bypass CAPTCHAs or use third-party solvers. If a verification or login challenge appears, automation pauses, brings the relevant window forward, and waits for you to complete the step manually.
  197. If your account uses Google, Microsoft, or Apple SSO, keep auth popups enabled in the Control Center. If embedded login remains unreliable, use Chrome CDP.
  198. ## Windows Notes
  199. Use Node.js 20 or 22 on Windows. Agentify Desktop is tested against Windows in CI, including the npm CLI launcher path.
  200. Chrome CDP is still the recommended backend on Windows because Google and Microsoft SSO can block embedded Electron login. Agentify looks for Chrome, Chromium, Brave, and Microsoft Edge in the usual install locations and on `PATH`.
  201. If Chrome CDP cannot find your browser, set the executable explicitly:
  202. ```powershell
  203. $env:AGENTIFY_DESKTOP_CHROME_BIN = "C:\Program Files\Google\Chrome\Application\chrome.exe"
  204. npx @agentify/desktop
  205. ```
  206. ## Local Data And Privacy
  207. Agentify Desktop is local-first:
  208. - The local API binds to `127.0.0.1`.
  209. - The local API requires a bearer token stored under `~/.agentify-desktop/`.
  210. - Electron browser data is stored under `~/.agentify-desktop/electron-user-data/`.
  211. - Chrome CDP profile data is stored under `~/.agentify-desktop/chrome-user-data/` unless you choose an existing profile.
  212. - Artifacts, bundles, logs, and state are stored under `~/.agentify-desktop/`.
  213. Anyone with access to your machine account may be able to access local session data. Treat the machine account as the security boundary.
  214. ## Environment Variables
  215. - `AGENTIFY_DESKTOP_STATE_DIR`: override the local state directory.
  216. - `AGENTIFY_DESKTOP_PORT`: choose the local API port.
  217. - `AGENTIFY_DESKTOP_SHOW_TABS=true`: show newly-created tabs by default.
  218. - `AGENTIFY_DESKTOP_MAX_TABS`: cap parallel tabs.
  219. - `AGENTIFY_DESKTOP_BROWSER_BACKEND=electron|chrome-cdp`: choose browser backend.
  220. - `AGENTIFY_DESKTOP_CHROME_BIN`: choose Chrome/Chromium executable.
  221. - `AGENTIFY_DESKTOP_CHROME_DEBUG_PORT`: choose Chrome debug port.
  222. - `AGENTIFY_DESKTOP_CHROME_PROFILE_MODE=isolated|existing`: choose Chrome profile mode.
  223. - `AGENTIFY_DESKTOP_CHROME_PROFILE_NAME`: choose an existing Chrome profile name.
  224. ## Development From Source
  225. Source checkout, quickstart script usage, local build commands, and source-only debugging notes live in [DEVELOPMENT_FROM_SOURCE.md](DEVELOPMENT_FROM_SOURCE.md).
  226. ## Package Commands
  227. The npm package exposes these commands:
  228. - `agentify-desktop`: default GUI launcher, with `mcp` subcommand support.
  229. - `agentify-desktop-gui`: explicit GUI alias.
  230. - `agentify-desktop-mcp`: explicit MCP alias.
  231. Examples:
  232. ```bash
  233. npx @agentify/desktop
  234. npx @agentify/desktop mcp
  235. npx -p @agentify/desktop agentify-desktop-mcp
  236. ```
  237. ## License And Trademarks
  238. The code is licensed under `MPL-2.0`. Agentify trademarks and branding are not included in that license. See [TRADEMARKS.md](TRADEMARKS.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.