Genesis Docs

genesis setup

Initialize ~/.genesis/genesis.json and the agent workspace.

Related:

Examples

genesis setup
genesis setup --workspace ~/.genesis/workspace
genesis setup --wizard
genesis 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:

genesis setup --wizard

Notes:

  • Plain genesis 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).

Related