From 99c9dd3cc20de819f9673591e78b13d598ba939c Mon Sep 17 00:00:00 2001 From: Josh Knapp Date: Thu, 27 Aug 2026 15:06:43 -0700 Subject: [PATCH] =?UTF-8?q?Add=20an=20Installation=20section=20=E2=80=94?= =?UTF-8?q?=20nothing=20told=20a=20new=20user=20how=20to=20get=20the=20app?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit HOW-TO-USE.md's Prerequisites jumped straight to Docker and a Claude Code account, assuming Triple-C was already installed; the app itself had no download/install instructions anywhere in the docs. Covers all six release assets, including the new Arch/CachyOS .pkg.tar.zst (triple-c#34) that publish-arch-package.yml now attaches to each release. --- HOW-TO-USE.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/HOW-TO-USE.md b/HOW-TO-USE.md index 9e30741..43b6955 100644 --- a/HOW-TO-USE.md +++ b/HOW-TO-USE.md @@ -6,6 +6,7 @@ Triple-C (Claude-Code-Container) is a desktop application that runs Claude Code ## Table of Contents +- [Installation](#installation) - [Prerequisites](#prerequisites) - [First Launch](#first-launch) - [The Interface](#the-interface) @@ -32,6 +33,23 @@ Triple-C (Claude-Code-Container) is a desktop application that runs Claude Code --- +## Installation + +Download the build for your platform from [GitHub Releases](https://github.com/shadowdao/triple-c/releases/latest). + +| Platform | File | Install | +|----------|------|---------| +| **Windows** | `Triple-C__x64-setup.exe` or `.msi` | Run the installer. | +| **macOS** | `Triple-C__universal.dmg` | Open the `.dmg` and drag Triple-C to Applications. | +| **Debian / Ubuntu** | `Triple-C__amd64.deb` | `sudo apt install ./Triple-C__amd64.deb` | +| **Fedora / RHEL** | `Triple-C--1.x86_64.rpm` | `sudo dnf install ./Triple-C--1.x86_64.rpm` | +| **Arch / CachyOS** | `triple-c-bin--1-x86_64.pkg.tar.zst` | `sudo pacman -U ./triple-c-bin--1-x86_64.pkg.tar.zst` | +| **Other Linux** | `Triple-C__amd64.AppImage` | `chmod +x` it, then run it directly. | + +> **macOS note:** The app is not signed or notarized. On first launch, macOS Gatekeeper may block it — right-click the app and select "Open" to bypass, or remove the quarantine attribute: `xattr -cr /Applications/Triple-C.app`. + +> **Arch / CachyOS note:** This package is not on the AUR — it's a `pacman`-installable file built and attached to each GitHub release by a maintainer-triggered step (`.gitea/workflows/publish-arch-package.yml`), so it can lag behind the very latest release by a bit. See [`packaging/arch/README.md`](packaging/arch/README.md) for details, including why "-bin" and what's verified about it. + ## Prerequisites ### Docker -- 2.52.0