OpenChamber Desktop

🇺🇸 English | 🇧🇷 Português | 🇪🇸 Español | 🇫🇷 Français | 🇩🇪 Deutsch

The official-unofficial lightweight desktop launcher for OpenChamber.
A high-performance, secure, and cross-platform container for your OpenCode AI environment.

---

🚀 Quick Start

📋 Prerequisites

You need to have OpenCode installed separately. This script only installs the OpenChamber Desktop launcher, not OpenCode itself.

Install OpenCode first:

# Via Bun (recommended)
curl -fsSL https://bun.sh/install | bash
bun install -g @openchamber/web

# Or via npm
npm install -g @openchamber/web

📦 Install

Windows (PowerShell - Admin):

irm https://raw.githubusercontent.com/aencyorganization/openchamber-desktop/main/scripts/install.ps1 | iex

Linux / macOS (Bash):

curl -fsSL https://raw.githubusercontent.com/aencyorganization/openchamber-desktop/main/scripts/install.sh | bash

🔄 Update

Windows:

irm https://raw.githubusercontent.com/aencyorganization/openchamber-desktop/main/scripts/update.ps1 | iex

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/aencyorganization/openchamber-desktop/main/scripts/update.sh | bash

🗑️ Uninstall

Windows:

irm https://raw.githubusercontent.com/aencyorganization/openchamber-desktop/main/scripts/uninstall.ps1 | iex

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/aencyorganization/openchamber-desktop/main/scripts/uninstall.sh | bash

---

✨ Features

Feature	Description
🎯 Smart Package Manager	Automatically selects the best available runtime (Bun → pnpm → npm).
🎨 Modern Shortcuts	Native desktop entries with proper icons and OS integration.
⚡ Single Instance	Ensures only one window runs at a time.
🔍 Auto-Detection	Automatically locates openchamber in your system PATH.
🔒 Secure Sandbox	Runs the web interface in a hardened iframe.
🧹 Lifecycle Management	Automatically terminates all processes when you close the app.

---

📦 Alternative Installation

If you prefer manual control:

Bun:

bun install -g openchamber-desktop

NPM:

npm install -g openchamber-desktop

PNPM:

pnpm add -g openchamber-desktop

---

🎮 Usage

Once installed:

• ocd - Launches the application (shorthand)
• openchamber-desktop - Launches the application

---

🎹 Keyboard Shortcuts

Shortcut (PC)	Shortcut (Mac)	Action
F11	F11	Toggle Fullscreen
Ctrl + +	Cmd + +	Zoom In
Ctrl + -	Cmd + -	Zoom Out
Ctrl + 0	Cmd + 0	Reset Zoom
Ctrl + Q	Cmd + Q	Quit

---

🔧 Troubleshooting

Problem: App says "OpenChamber not found"
Solution:

# Install OpenCode first
bun add -g @openchamber/web
# or
npm install -g @openchamber/web

Problem: Port conflicts
Solution:

# Kill process on port 1504
lsof -ti:1504 | xargs kill -9

---

🚧 Development

# Clone & Install
git clone https://github.com/aencyorganization/openchamber-desktop.git
cd openchamber-desktop
bun install

# Run Development Mode
bun run dev

---

🤝 Contributing

See CONTRIBUTING.md

---

📄 License

GNU General Public License v3.0 (GPL-3.0)

See LICENSE

---

Made with 💚 by Aency Organization