Illustrative mockup. The profiles, paths, addresses, ports, and log values are fictional.
An unofficial desktop launcher for managing
@evenrealities/even-terminal
connection profiles from the macOS menu bar or Windows system tray.
This launcher was created and is maintained independently by 3mintimer. It is not an official Even Realities product and is not endorsed by or affiliated with Even Realities.
This is a personal project maintained for the author's own use. Pull requests, feature requests, and general support are not currently accepted. You are welcome to fork the MIT-licensed code and maintain your own version.
Brand assets are excluded from the MIT License and must be replaced or handled separately. Security reports are handled separately under the security policy.
- macOS Apple Silicon: locally verified.
- Windows: implementation, CI, and unsigned packaging are prepared, but the application has not been accepted on a Windows machine.
- Public releases: not available yet. Current macOS packages use ad-hoc signing and are intended for local testing.
- Linux: outside the current project scope.
See Windows readiness for the exact verification boundary.
- Run multiple Even Terminal profiles from a menu bar or tray application.
- Configure Claude Code or Codex, working directory, HTTP port, and Codex app-server port per profile.
- Detect port conflicts and supervise start, health check, restart, and stop.
- Store bridge tokens with Electron
safeStorageand pass them to child processes throughBRIDGE_TOKEN, never command-line arguments. - Connect over LAN, Tailscale-advertised addresses, selected interfaces, or supported tunnel helpers.
- Redact tokens from profile logs and diagnostics.
- Check, install, activate, and roll back isolated Even Terminal runtimes.
- Export and import portable profile configuration without tokens or executable overrides.
- Use Japanese, English, Simplified Chinese, Traditional Chinese, Korean, or Spanish UI.
- Node.js 24.18.0 (pinned in
mise.toml) - npm
- An installed and authenticated
claudeorcodexcommand - For device use: Even Realities G2 and the Even app
The application embeds Even Terminal 0.8.1 as its initial runtime.
git clone <repository-url>
cd even-hub-launcher
mise install
mise exec -- npm ci
mise exec -- npm run devIf you do not use mise, install Node.js 24.18.0 and run the npm commands
directly.
- Start the launcher. On macOS it remains in the menu bar.
- Open the launcher window and create a profile.
- Choose Claude Code or Codex and select the profile's working directory.
- Keep the suggested HTTP and Codex app-server ports, or choose two unused ports. Every profile must have a unique pair.
- Select a connection transport and start the profile.
- Open the connection details, then use the URL/QR information in the Even app.
- Stop the profile from the launcher when finished.
Tokens are stored locally and are intentionally omitted from configuration exports.
npm ci
npm run typecheck
npm run lint
npm test
npm run license:check
npm run build
npm run smoke # macOS
npm run packagenpm run package creates a local unsigned/ad-hoc-signed host package. It does
not create a notarized macOS release or a signed Windows installer.
Even Terminal 0.8.1 listens on 0.0.0.0, including when --tailscale is used.
That option selects the advertised Tailscale address; it does not restrict the
server to the Tailscale interface. Treat connection URLs and bridge tokens as
credentials, and use a trusted network path.
The launcher code and documentation created by 3mintimer are available under the MIT License, except where explicitly noted.
The icons and preview image were prepared for this project, but they incorporate an Even Realities brand mark. 3mintimer does not claim ownership of that mark, so these image files are not offered under the MIT License. See Brand asset notice and NOTICE.md.
Even Terminal, the Claude Agent SDK, and other dependencies remain under their respective terms. The current audit is documented in Third-party notices and the generated dependency license inventory. Confirm the unresolved Even Terminal redistribution terms and permission for the brand assets before distributing packaged builds.