Skip to main content

​
CLI reference

fased is the scriptable control surface for Fased. It is not just a Gateway wrapper. The CLI manages:
  • onboarding and install flows
  • config and secrets
  • Agent workspaces, chat app accounts, routing, skills, services, tools, and tasks
  • live gateway control and diagnostics
  • plugins, skills, and hooks
  • wallets, Fased Network, and mining where enabled
For the short command list, start with CLI Cheatsheet. The browser setup path is Agent-first: open Agents, select an Agent, then use Models, Channels, Skills, Tools, Memory, Sessions, Services, Tasks, Coordination, and Files. CLI commands are the scriptable/admin equivalent. Diagnostics map to Logs, Usage, Advanced > Debug, and Advanced > Nodes.

​
Command map

​
Main command groups

Setup and lifecycle

Onboarding, config, update, uninstall, shell completion, and reset flows.

Runtime and ops

Gateway control, health, doctor, logs, services, security, secrets, and sandboxing.

Agents and tasks

Agents, messages, sessions, memory, task definitions, hooks, approvals, and skills.

Channels and devices

Channel accounts, pairing, QR flows, local nodes, browser, voice call, and DNS.

Models and plugins

Model selection, provider status, plugin management, and ACP agents.

Wallet and network

Wallets, mining, Fased Network, directory, federation, and SAT operator operations.
cron is still documented as a compatibility alias for task. daemon is still documented as a compatibility service command.

​
Global flags

  • --dev
    • isolate state under ~/.fased-dev
  • --profile <name>
    • isolate state under ~/.fased-<name>
  • --no-color
    • disable ANSI colors
  • --update
    • shorthand for fased update
  • -V, --version, -v
    • print version and exit

​
Output behavior

  • human output is styled only in TTY sessions
  • --json disables styling and is the preferred scripting mode
  • --no-color and NO_COLOR=1 disable ANSI colors
  • progress indicators are shown for long-running commands when the terminal supports them

​
CLI palette

  • default/bold text: wizard titles
  • warn / yellow: section labels, blockers, fallbacks, warnings
  • success / green: commands, URLs, tokens, copyable values, successful states
  • default text: short explanations and comments
  • error / red: errors and failed states only
  • muted / gray: frames, separators, secondary metadata

​
Important current behavior

  • install and update are still repo-backed by default
  • fased onboard --install-daemon is for setup and service installation, not the primary version-update path
  • plugin and hook installs are executable-code paths; treat them with the same care as normal software installs
  • legacy alias namespaces remain supported for migration, but the main docs should prefer the top-level fased ... forms