Introduction

OpenWarden is a native macOS menu bar application that supervises local OpenCode and OpenChamber servers.

The application is built specifically for Apple Silicon and macOS Tahoe. It does not use Tauri, Electron, or an embedded web view.

Features

Native AppKit menu bar integration
Independent OpenCode and OpenChamber status and process information
Dependency-aware start, stop, and restart actions
One-click copying of each server address, PID, and executable path
Hold Shift while opening the menu to replace running services' Stop actions with Restart
Native SwiftUI settings window
English and Italian localization
Automatic settings persistence
Optional launch at login and automatic service startup
OpenCode Basic Authentication and OpenChamber UI credentials stored in macOS Keychain
Automatic executable discovery through PATH and common Homebrew locations
No Dock icon

Requirements

Apple Silicon Mac (arm64)
macOS 26 Tahoe or later
Swift 6.2 or Xcode 26
OpenCode and OpenChamber installed in PATH, or explicit executable paths configured in Settings

Run For Development

Build and run the debug executable with Swift Package Manager:

make debug

Build The Application Bundle

Build the application bundle:

make release

The target:

Builds an optimized ARM64 release executable.
Creates a native application bundle.
Copies the application metadata from Resources/Info.plist.
Copies the OpenWarden application icon.
Applies an ad-hoc code signature.

The resulting bundle is written to:

build/OpenWarden.app

Launch it with:

open "build/OpenWarden.app"

Build and copy the application bundle to ~/Applications with:

make install

Remove Swift Package Manager and application bundle build artifacts with:

make clean

Configuration

Open Settings from the menu bar item to configure:

Launch at login and automatic OpenCode/OpenChamber startup
OpenCode executable, address, mDNS, CORS, and Basic Authentication
OpenChamber executable, address, API-only mode, and UI password

An empty executable path enables automatic discovery. The resolved executable is shown as the field placeholder.

Non-sensitive settings are encoded with Codable and stored in UserDefaults. Passwords are stored as separate generic password items in macOS Keychain.

OpenCode is started as:

opencode serve --hostname <hostname> --port <port>

OpenChamber is started in foreground mode and attached to the managed OpenCode server:

OPENCODE_HOST=http://127.0.0.1:2214 \ 
OPENCODE_SKIP_START=true \ 
openchamber serve --foreground --host 127.0.0.1 --port 2212

Both services use IPv4 addresses. A wildcard bind address (0.0.0.0) is normalized to 127.0.0.1 for health checks, copied addresses, and the OpenChamber upstream connection.

When configured, the application also supplies:

OPENCODE_SERVER_USERNAME 
OPENCODE_SERVER_PASSWORD

Project Structure

Package.swift 
Makefile 
Resources/ 
  Info.plist 
  OpenWarden.svg 
  OpenWarden-1024.png 
  OpenWarden.icns 
  OpenWardenTray.svg 
  OpenWardenTray.png 
Sources/OpenWarden/ 
  AppModel.swift 
  KeychainStore.swift 
  LauncherSettings.swift 
  Localization.swift 
  MenuBarController.swift 
  OpenWardenApp.swift 
  Resources/ 
    en.lproj/Localizable.strings 
    it.lproj/Localizable.strings 
  ServiceStatus.swift 
  SettingsView.swift 
  SettingsWindowController.swift

Notes

Settings changes are saved automatically.
Configuration changes apply the next time the server starts or restarts.
Starting OpenChamber starts OpenCode first and waits for it to become healthy.
Stopping OpenCode stops OpenChamber first.
Restarting OpenCode restores OpenChamber when it was previously running.
OpenChamber binds to 127.0.0.1 by default; binding to 0.0.0.0 requires an OpenChamber UI password.
Closing the Settings window hides it without terminating the application.
Choosing Exit terminates both managed services.

Copyright

Licensed under the ISC license, which can be found at https://choosealicense.com/licenses/isc.