Unbound Force Get Started

uf CLI Reference

This page reflects uf v0.12.0. Run uf --help for the latest.

Overview

uf [command] [flags]

The uf CLI (alias for unbound-force) manages the full Unbound Force toolchain. Each command group handles a distinct concern — from project scaffolding to containerized development sessions.

Global flags:

FlagDescription
-h, --helpHelp for any command
-v, --versionPrint the uf version

init

Scaffold the Unbound Force specification framework into the current directory. Creates Speckit templates, scripts, OpenCode commands and agents, Divisor review personas, convention packs, and OpenSpec schema files.

User-owned files (templates, scripts, agents, config) are skipped if they already exist. Tool-owned files (Speckit commands, OpenSpec schema, convention packs) are updated if their content has changed.

uf init [flags]
FlagDescription
--divisorDeploy only Divisor review agents and convention packs
--forceOverwrite all existing files
--lang <string>Project language for convention pack selection (auto-detected from go.mod, package.json, etc. if omitted)

setup

Install and configure the Unbound Force development toolchain. Detects existing version and package managers, installs missing tools through the appropriate manager, configures the Swarm plugin in opencode.json, and scaffolds project files. Idempotent — safe to run multiple times.

uf setup [flags]
FlagDescription
--dir <string>Target directory for setup (default .)
--dry-runPrint actions without executing
--yesSkip confirmation prompts for curl|bash installs

See the Quick Start for a walkthrough of uf setup.

doctor

Check for required tools, version managers, scaffolded files, hero availability, Swarm plugin status, MCP server configuration, and agent/skill integrity. Produces a colored terminal report by default, or structured JSON for CI pipelines.

Exit code 0 when all checks pass or only warnings exist. Exit code 1 when any check fails.

uf doctor [flags]
FlagDescription
--dir <string>Target directory to check (default .)
--format <string>Output format: text or json (default text)

config

Manage the unified .uf/config.yaml configuration file.

uf config [command] [flags]

Subcommands

SubcommandDescription
initCreate or update .uf/config.yaml
showDisplay effective configuration after all layers merge
validateValidate config file against known field values

config init

uf config init [flags]
FlagDescription
--dir <string>Target directory (default .)

config show

uf config show [flags]
FlagDescription
--dir <string>Target directory (default .)
--format <string>Output format: text or json (default text)

config validate

uf config validate [flags]
FlagDescription
--dir <string>Target directory (default .)
--format <string>Output format: text or json (default text)

sandbox

Launch, manage, and extract changes from containerized OpenCode development sessions. Supports Podman (local) and Eclipse Che / Dev Spaces (CDE) backends.

uf sandbox [command] [flags]

Subcommands

SubcommandDescription
createProvision a persistent sandbox workspace
startLaunch or resume a sandbox
stopStop a sandbox (preserves persistent state)
attachConnect to a running sandbox’s TUI
extractExtract changes from the sandbox as git patches
statusShow sandbox workspace status
destroyPermanently delete a sandbox workspace

gateway

Start a local reverse proxy that serves the Anthropic Messages API. The gateway auto-detects the cloud provider from environment variables and injects host-side credentials into upstream requests.

Supported providers:

  • Anthropic (ANTHROPIC_API_KEY)
  • Vertex AI (CLAUDE_CODE_USE_VERTEX=1 + ANTHROPIC_VERTEX_PROJECT_ID)
  • AWS Bedrock (CLAUDE_CODE_USE_BEDROCK=1)
uf gateway [flags]
FlagDescription
--detachRun gateway in the background
--port <int>Port to listen on (default 53147)
--provider <string>Provider override: anthropic, vertex, or bedrock (auto-detected if omitted)

Subcommands

SubcommandDescription
statusShow gateway status
stopStop a running gateway

See Also

Next
Configuration