Installation

Quick Install

The fastest way to install JacqOS on macOS or Linux:

curl -fsSL https://www.jacqos.io/install.sh | sh

This detects your platform, downloads the correct bundle from GitHub Releases, verifies the checksum, and installs to ~/.local/bin.

The installer falls back from the latest stable release to the latest installable preview bundle when a stable bundle is not published for your platform yet.

The official bundle seeds the bundled jacqos-chevy-offer-containment and jacqos-drive-thru-ordering workspaces under ~/JacqOS/workspaces/examples/ so Studio can open real local JacqOS apps on first run.

Pin a specific version:

JACQOS_VERSION=0.4.1-preview curl -fsSL https://www.jacqos.io/install.sh | sh

Custom install directory:

JACQOS_INSTALL_DIR=/opt/jacqos/bin curl -fsSL https://www.jacqos.io/install.sh | sh

Manual Download

If you prefer to download and install manually, grab the bundle from GitHub Releases. You do not need Rust, Cargo, Node.js, or any compilation toolchain.

Platform	Asset	Status	Install path
Linux x86_64	`jacqos-linux-x86_64.tar.gz` or `jacqos-linux-x86_64-preview.tar.gz`	GA or preview	Extract and run `./install.sh`
Linux arm64	`jacqos-linux-arm64.tar.gz` or `jacqos-linux-arm64-preview.tar.gz`	GA or preview	Extract and run `./install.sh`
macOS arm64	`jacqos-macos-arm64.zip`	GA only when signed and notarized	Extract and run `./install.sh`
macOS arm64 preview	`jacqos-macos-arm64-preview.zip`	Preview only	Extract and run `./install.sh`
Windows x86_64	`jacqos-windows-x86_64-preview.zip`	Preview	Extract and run `install.ps1`
macOS x86_64	not published	Not shipped in V1	Use Apple Silicon or the contributor path

The bundle always includes:

jacqos
the private jacqos-studio helper
a bundled workspace at ~/JacqOS/workspaces/examples/jacqos-incident-response

Launch Studio only through jacqos studio.

Linux x86_64

curl -fsSLO https://github.com/Jacq-OS/jacqos/releases/latest/download/jacqos-linux-x86_64.tar.gz
tar -xzf jacqos-linux-x86_64.tar.gz
./jacqos-*/install.sh

macOS arm64

Download jacqos-macos-arm64.zip from the release page. If the macOS asset is still in preview, the filename ends with -preview.zip.

unzip jacqos-macos-arm64.zip
./jacqos-*/install.sh

Windows x86_64

Run the PowerShell installer or download jacqos-windows-x86_64-preview.zip from the release page.

iwr https://www.jacqos.io/install.ps1 -UseBasicParsing | iex

Expand-Archive .\jacqos-windows-x86_64-preview.zip -DestinationPath .
.\jacqos-*\install.ps1

Verify

$ jacqos --version
jacqos <version>

Then launch Studio:

jacqos studio

On a fresh install without a default workspace, Studio opens Workspace automatically.

If Studio instead shows Home with no loaded data, click OPEN WORKSPACE.

In Bundled Examples, choose Incident Response (Bundled Example) and click OPEN.

Home then shows either RUN DEMO or RESET DEMO, depending on whether the local workspace already has demo state.

Updating

Once installed, update to the latest version with:

jacqos self-update

This checks GitHub Releases for the latest version, downloads the correct binary for your platform, verifies its checksum, and replaces the installed binary in place.

To check for updates without installing:

jacqos self-update --check

What You Get

The official install includes everything you need for local development, Studio inspection, and the first cloud publish flow:

Bundled Studio demo — open real local Chevy Offer Containment and Drive-Thru Ordering workspaces
Scaffold — generate new app directories
Dev shell — watch files, hot-reload ontology and mappers in under 250ms
Replay — deterministic replay of fixture files
Verify — run all invariants and fixtures with a single command
Studio — operator surface for the drill inspector, timeline, and ontology browser, launched with jacqos studio
Cloud commands — sign in, select a scope, publish, issue a scoped runtime token, send observations, and replay hosted evidence
Export — freeze evaluation packages, hosted evidence, and observation logs

If the bundled workspace destination already exists, the installer leaves it in place instead of overwriting user-owned changes.

No plugins, no extensions, no separate installs. One bundle does it all.

System Requirements

Linux x86_64
macOS 13+ on Apple Silicon
Windows x86_64 preview
No runtime dependencies

Contributor Path

If you are developing inside this repository, cargo install --path tools/jacqos-cli remains available as the contributor-only path. The supported end-user install story is the official release bundle above.