agent-zero icon indicating copy to clipboard operation
agent-zero copied to clipboard

feat(desktop): implement electron desktop shell integration

Open TerminallyLazy opened this issue 2 months ago • 0 comments

Description

This PR introduces a native Electron desktop shell for Agent Zero. It wraps the existing Docker-based setup in a desktop application, providing a connection wizard, native window management, and improved system integration.

Key Changes

  • Electron App: Created desktop/electron with main.js, preload.js, and wizard.html.
  • Connection Wizard: A startup screen that checks if the Agent Zero Docker container is running and allows the user to start it.
  • Build System: Configured electron-builder to generate native executables (DMG for macOS).
  • IPC Bridge: Secure contextBridge implementation to allow the frontend to communicate with the Docker daemon and backend API.
  • Assets: Added application icons and logo assets.

Testing

  1. Navigate to desktop/electron.
  2. Run npm install.
  3. Run npm start to launch the development version.
  4. Verify the connection wizard detects the Docker container (or offers to start it).
  5. Build the app using npm run build:mac and verify the .dmg works.

Notes

  • The app expects Docker to be installed and accessible on the host.
  • DevTools are enabled by default in this build for debugging purposes.

TerminallyLazy avatar Nov 19 '25 15:11 TerminallyLazy