@fabledos/cli

The FabledOS command-line interface (fabled) as an npm package.

npm install -g @fabledos/cli
# or per-project
npm install --save-dev @fabledos/cli

The package is a thin shim: on install, a postinstall script downloads the platform-native fabled binary from the corresponding GitHub Release, verifies its SHA-256 against the release's checksums.txt, and places it at node_modules/@fabledos/cli/bin/fabled-bin. Subsequent fabled <verb> invocations exec that binary directly — no Node runtime overhead per command.

Supported platforms

| OS | Arch | Target triple | | --- | --- | --- | | macOS | arm64 (Apple Silicon) | aarch64-apple-darwin | | macOS | x64 (Intel) | x86_64-apple-darwin | | Linux | x64 (glibc) | x86_64-unknown-linux-gnu | | Linux | x64 (musl, e.g. Alpine) | x86_64-unknown-linux-musl | | Linux | arm64 | aarch64-unknown-linux-gnu | | Windows | x64 | x86_64-pc-windows-msvc |

Alternative install paths

• macOS: brew install himudianda/fabledos/fabled
• Windows: scoop bucket add fabledos https://github.com/himudianda/scoop-fabledos && scoop install fabled
• Direct download: GitHub Releases (binary-only mirror of the private source repo)

Behind a corporate firewall

If the postinstall cannot reach github.com:

1. Download the matching archive from a mirror or a machine with access.
2. Verify its SHA-256 against the consolidated checksums.txt.
3. Extract the fabled binary anywhere on your $PATH.

The CLI does not require @fabledos/cli to be installed — it's just a distribution convenience.

After install

fabled --version
fabled doctor        # diagnose the install + daemon + auth state
fabled daemon status # auto-spawns the daemon on first call
fabled auth login    # browser handshake → keychain

See the project docs for the full verb reference.

License

Apache-2.0