> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluffbuzz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup

# `fluffbuzz setup`

Initialize `~/.fluffbuzz/fluffbuzz.json` and the agent workspace.

Related:

* Getting started: [Getting started](/start/getting-started)
* CLI onboarding: [Onboarding (CLI)](/start/wizard)

## Examples

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
fluffbuzz setup
fluffbuzz setup --workspace ~/.fluffbuzz/workspace
fluffbuzz setup --wizard
fluffbuzz setup --non-interactive --mode remote --remote-url wss://gateway-host:18789 --remote-token <token>
```

## Options

* `--workspace <dir>`: agent workspace directory (stored as `agents.defaults.workspace`)
* `--wizard`: run onboarding
* `--non-interactive`: run onboarding without prompts
* `--mode <local|remote>`: onboarding mode
* `--remote-url <url>`: remote Gateway WebSocket URL
* `--remote-token <token>`: remote Gateway token

To run onboarding via setup:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
fluffbuzz setup --wizard
```

Notes:

* Plain `fluffbuzz setup` initializes config + workspace without the full onboarding flow.
* Onboarding auto-runs when any onboarding flags are present (`--wizard`, `--non-interactive`, `--mode`, `--remote-url`, `--remote-token`).