v4.1.0Home

Installation

One static binary, available on every channel you'd expect. Pick the install path that matches your platform — the same Foxora Shell experience falls out the other side.

2 minBeginner
Before you start
  • macOS 12+ / Windows 10+ / Linux with glibc 2.31+
  • A package manager you already use (brew / winget / scoop / cargo) — optional

Install Foxora Shell

  1. Pick your platform

    brew install foxora-shell
    
    # Or via the universal installer:
    curl -fsSL https://get.foxoraos.com | sh
    foxsh installed
    One static binary across every channel — Apple-notarised on macOS, Authenticode-signed on Windows, Ed25519-signed on Linux.
  2. Launch the shell

    The binary is named foxsh with a foxora symlink for discoverability. Open a Foxora Shell window:

    bash
    foxsh
    # or the long form:
    foxora

    On first launch you'll see the standard chrome — titlebar with traffic lights (macOS) or native controls, a top bar with cwd + fur badge + git branch, and a footer with the ready dot and identity.

  3. Confirm fur is embedded

    fur is part of the Shell binary — nothing extra to install. From inside Foxora Shell:

    bash
    fur version
    # foxora-shell 1.0  ·  fur 1.4  ·  ratatui 0.27
    
    fur doctor

    Cross-platform parity

    fur behaves identically on every platform. The backend (Homebrew / apt / Nix / Scoop / winget) is selected automatically — you never see the difference. See platform notes for the underlying matrix.

Continue in Getting Started

Where to next