Install

Install Hangar

For Windows and Linux x64. Download, run, done: on Windows, Hangar installs for your user only, without administrator rights.

Download Hangar-Setup.exe For Linux

Version 0.11.0 · Nov 18, 2026 · 11.0 MB

Windows 10 (1809 or later) or Windows 11, x64. Free and open source.

Installation on Windows

  1. Download the installer

    Use the button above. The file comes straight from the official release on GitHub.

  2. Run the installer

    Open the file. Hangar installs for your user only and needs no administrator rights.

  3. Confirm the SmartScreen notice

    If Windows shows a blue SmartScreen notice, continue like this:

    1. Click More info.
    2. Check that the app shown is Hangar-Setup.exe.
    3. Click Run anyway.

    Why? The installer is not yet signed with a code signing certificate, so Windows does not know it yet. The labels may differ slightly depending on your Windows version and language.

  4. Start Hangar

    Once installed, start Hangar from the Start menu.

Installation on Linux

New since Hangar 0.11: Linux x64 with glibc 2.34 or later, that is Ubuntu 22.04, Debian 12 or newer. Pick one of the two packages.

  1. AppImage: runs without installing and updates itself

    Download the file, make it executable and start it. Hangar then updates itself, just like on Windows.

    Download the AppImage

    cd ~/Downloads
    chmod +x Hangar_*.AppImage
    ./Hangar_*.AppImage
  2. .deb for Debian and Ubuntu

    Installs Hangar through the package manager, with an entry in your app menu. You install updates the same way, by hand.

    Download the .deb

    cd ~/Downloads
    sudo apt install ./Hangar_*_amd64.deb

Linux support is new. If something does not work, please report it on GitHub. If you saved the file somewhere else, change the folder in the command.

Requirements

Operating system
Windows 10 version 1809 or later, or Windows 11 (x64). Linux x64 with glibc 2.34 or later (Ubuntu 22.04, Debian 12 or newer).
Rights
No administrator rights needed on Windows: Hangar installs for your user only. On Linux, the AppImage needs none either; the .deb is installed with sudo.
Agents
The command line tools of the agents you want to use (Claude Code, Codex CLI, Gemini CLI, Aider and more), with your own accounts. Hangar finds them on your PATH.
Git
Needed for team sessions (worktrees), change tracking, commits and shared notes.
Team features
A Hangar account, created in the browser when you sign in.

Verify the checksum (optional)

The SHA-256 checksum of Hangar-Setup.exe for version 0.11.0:

30a5e518e3e6c3277dec1bf29b885141eb03740bdaeabb0579c32c301d2e7015

Check the file in PowerShell. If the output is True, the file is exactly the one from the release.

(Get-FileHash "$env:USERPROFILE\Downloads\Hangar-Setup.exe" -Algorithm SHA256).Hash -eq "30a5e518e3e6c3277dec1bf29b885141eb03740bdaeabb0579c32c301d2e7015"

If you saved the file somewhere else, adjust the path. The checksum only belongs to this version.

Updates

Hangar looks for new versions by itself. Updates are signed, and Hangar only installs an update whose signature checks out.

See what is new in the changelog

First steps

  1. Start an agent

    Pick a project folder under New session, choose Private or Team and click an agent. Hangar lists every agent it finds on your machine, with its version; under Team only those that can run as team sessions.

  2. Bring in your team (optional)

    Click Sign in at the bottom of the sidebar, confirm the code in your browser, then click Connect for your project. Teammates who join the same project see each other in the Team window.

Ctrl+Shift+P opens quick access (sessions, files, commits, settings and every menu command), Ctrl+Shift+S searches the output of all sessions, Ctrl+Shift+M shows all sessions as live tiles, Ctrl+Shift+H the home view, Ctrl+Shift+N opens a quick note and Ctrl+, the settings.

macOS

A version for macOS is planned. Join the waitlist and we will let you know when it is ready.

Join the waitlist