v4.1.0Home

Quickstart

From a fresh install to a healthy system, an installed app, a verified kit, and a JSON-driven automation gate — in about five minutes.

5 minBeginner
Before you start
  • fur installed (see Installation)
  • jq for the structured-output examples

Walkthrough

  1. Confirm the host is healthy

    bash
    fur doctor --json | jq -e '.checks | all(.ok == true)'

    doctor is non-mutating. If a backend is missing it tells you exactly which one and how to install it.

  2. Install your first app

    Fur tries each available source in order until one resolves the target. You can pin a backend with --from:

    bash
    fur install hello

# Force a specific backend:
fur install hello --from nixpkgs
fur install firefox --from flatpak
    fur install hello
    The same command resolves to nixpkgs, AppImage, .deb, Flatpak, or a Kit.

  3. See what's installed

    bash
    fur list --json | jq '.apps[] | {name, source, strategy}'

    Every record carries its source and strategy, plus optional provenance for kits.

  4. Verify a signed kit

    Kits are signed bundles with immutable provenance. Enforce signatures and pinning end-to-end:

    bash
    export FOXORA_KIT_TRUST_POLICY=signature-required
export FOXORA_KIT_PIN_POLICY=require-pinned

fur install @foxora/dev-tools --json | jq '.attestation'

    Why kits?

    Kits give you "this is exactly the binary I expected" guarantees. Trust + pin policy is enforced at install, and the attestation hash is recorded in the manifest.

  5. Open the logs dashboard

    bash
    fur logs --web

    A browser tab opens with command frequency, success rates, and latency summaries. Useful when scripting or debugging a flaky host.

Continue in Getting Started

Overview

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

Installation

Install fur via Nix, Homebrew, npm, Chocolatey, or signed GitHub assets.

Where to next