Skip to content
FabioFabio
Blog

Getting started

This tutorial takes you from a new machine to a working Microsoft Fabric workspace. Fabio is non-interactive after authentication and emits structured JSON by default, so the same commands work for people, scripts, and coding agents.

1. Install Fabio

Section titled “1. Install Fabio”

Linux or macOS

Section titled “Linux or macOS”
Terminal window
curl -fsSL https://raw.githubusercontent.com/iemejia/fabio/main/install.sh | bash

The installer places the binary in ~/.local/bin. Open a new shell if that directory was added to your PATH.

Windows

Section titled “Windows”
Terminal window
irm https://raw.githubusercontent.com/iemejia/fabio/main/install.ps1 | iex

The installer places Fabio in %LOCALAPPDATA%\fabio and updates your user PATH.

Docker

Section titled “Docker”
Terminal window
docker pull ghcr.io/iemejia/fabio:latest
docker run --rm ghcr.io/iemejia/fabio --help

Pre-built binaries for Linux, macOS, and Windows on x64 and arm64 are also available from GitHub Releases.

Verify the installation:

Terminal window
fabio --version

2. Sign in

Section titled “2. Sign in”

Use device-code authentication:

Terminal window
fabio auth login

Follow the URL shown in the structured response and enter the device code. To use a browser redirect instead:

Terminal window
fabio auth login --browser

For CI, use a service principal or workload identity rather than an interactive login. See Authentication.

3. Inspect your tenant

Section titled “3. Inspect your tenant”
Terminal window
fabio workspace list --limit 10

Fabio returns a stable list envelope:

{"data":[{"id":"…","displayName":"Analytics"}],"count":1}

Use -o table when reading the result yourself, or keep the default JSON when composing commands.

4. Create a workspace

Section titled “4. Create a workspace”
Terminal window
fabio workspace create --name "analytics"

Preview a mutation without sending it:

Terminal window
fabio workspace create --name "analytics" --dry-run

If the workspace needs capacity, assign it after creation:

Terminal window
fabio workspace assign-capacity --id <workspace-id> --capacity <capacity-id>

5. Let an agent use Fabio

Section titled “5. Let an agent use Fabio”

Install Fabio’s root skill and its focused workload skills:

Terminal window
npx skills add https://github.com/iemejia/fabio

The skill teaches compatible agents how to discover commands, preserve structured output, and handle destructive operations safely. Continue with Use Fabio with coding agents.

Next steps

Section titled “Next steps”