Skip to main content

​
CLI Cheatsheet

Use this page when you know what you want to do and need the command quickly. The full reference pages explain options and edge cases.

​
Installed CLI vs source checkout

Most docs use the installed command: 
fased <command>
When you are inside a source checkout and have already built the repo, use: 
node fased.mjs <command>
Build first if dist/entry.js is missing: 
pnpm install
pnpm build

​
Open the Control UI

Open the dashboard: 
fased dashboard
Print the auth-ready URL without opening a browser: 
fased dashboard --no-open
Source checkout: 
node fased.mjs dashboard --no-open
Print only the raw Gateway token: 
fased config get gateway.auth.token

​
Start the Gateway

Foreground local gateway: 
fased gateway run --port 18789 --bind loopback
Foreground local gateway from a source checkout: 
node fased.mjs gateway run --port 18789 --bind loopback
Force-replace a stuck local listener: 
fased gateway run --port 18789 --bind loopback --force
Use the service path when Fased is installed as a daemon: 
fased gateway status
fased gateway restart

​
Health and repair

Fast health check: 
fased gateway status
Connection probe: 
fased gateway probe
General repair: 
fased doctor
fased doctor --fix
Generate a missing Gateway token: 
fased doctor --generate-gateway-token
Tail logs: 
fased logs --limit 100
fased logs --follow

​
Config quick reads

fased config get gateway.port
fased config get gateway.bind
fased config get gateway.auth.mode
fased config get gateway.auth.token
Use fased config set ... for small config changes. Prefer the Control UI for normal setup because it validates related fields together.

​
Profiles

Use an isolated dev profile: 
fased --dev gateway run
fased --dev dashboard --no-open
Use a named profile: 
fased --profile screenshot gateway run --port 19001
fased --profile screenshot dashboard --no-open
Profiles keep config and state separate under ~/.fased-<name>.

​
Channels

List configured channels: 
fased channels list
Probe channel status: 
fased channels status --probe
Link a supported channel account: 
fased channels login --channel whatsapp
Resolve IDs for allowlists or routing: 
fased channels resolve

​
Wallets and SAT mining

Wallet status: 
fased wallet status
Mining readiness: 
fased mining readiness
Mining status: 
fased mining status
List mining-eligible wallets: 
fased mining wallets
Set a mining commit: 
fased mining set-commit --sol 0.75
Start or stop mining: 
fased mining start
fased mining stop

​
Script-friendly output

Use JSON when another tool reads the result: 
fased gateway status --json
fased channels status --json
fased mining status --json
Use plain output for terminals or copied logs: 
fased logs --plain --limit 100