v4.1.0Home

Installation

Install fur on any of the supported channels — Nix flake, Homebrew, npm, Chocolatey, or the signed GitHub release. The CLI is a single static binary.

3 minBeginner
Before you start
  • A 64-bit Linux, macOS, or Windows machine
  • A package manager you already use (brew / npm / nix / choco) — optional

Install fur

  1. Pick an install channel

    All channels ship the same statically-linked binary. Use whichever matches your environment:

    # Add to your flake inputs:
#   fur.url = "github:foxora/fur";
#
# Or run ad-hoc:
nix run github:foxora/fur -- --version
    fur installed
    One static binary, several install channels — pick whichever you already trust.

  2. Verify the install

    Confirm the binary is on your PATH and the runtime backends fur talks to are healthy:

    bash
    fur --version
# → fur 4.1.0

fur doctor --json | jq '.checks'

    Doctor is your friend

    fur doctor is the canonical "is the host ready?" check. It surfaces missing backends (nix, flatpak, dpkg-deb, steam-run, appimage-run) with an actionable hint per failure.

  3. Optional: enable apt habit compatibility

    If you want existing scripts and muscle memory to keep working, symlink the bundled wrapper binaries into your PATH:

    bash
    sudo ln -sf "$(fur which compat/apt)"     /usr/local/bin/apt
sudo ln -sf "$(fur which compat/apt-get)" /usr/local/bin/apt-get
    apt → fur apt
    apt-style commands now route through fur, with the same JSON contract.

Continue in Getting Started

Overview

Fur — the unified Foxora CLI for apps, profiles, system, services, kits, and MCP.

Quickstart

From a fresh install to a verified kit and a JSON-driven gate in five minutes.

Where to next