setup

Reference for flywheel setup.

Command Group

Setup Commands

Configure host skills or MCP; CLI mode also writes user TOML.

flywheel setup [FLAGS]

None.

Flag	Value	Default	Choices	Description
`-h, --help`				Show this help.
`--claude`				Set up for Claude Code
`--cursor`				Set up for Cursor
`--universal`				Set up for Universal (.agents/skills)
`--antigravity`				Set up for Antigravity (.agent/skills)
`--opencode`				Set up for OpenCode
`--codex`				Set up for Codex
`--gemini`				Set up for Gemini CLI
`--pi-mono`				Set up for Pi (pi-mono)
`--hermes-agent`				Set up for Hermes Agent
`--openclaw`				Set up for OpenClaw
`--mode`	`MODE`		`mcp`, `cli`	Install mode: mcp \| cli
`--mcp`				Alias for --mode mcp
`--cli`				Alias for --mode cli
`-p, --project`				Configure for current project instead of globally
`-y, --yes`				Skip confirmation prompts
`--api-key`	`KEY`			Use API key authentication
`--api-key-stdin`				Read one API key privately from stdin without browser authentication
`--oauth`				Use OAuth endpoint (IDE handles auth flow)
`--install-skill`				Install or refresh the bundled Flywheel skills
`--skip-skill`				Skip bundled skill installation (MCP-only setup)
`--auth-mode`	`MODE`	`auto`	`auto`, `loopback`, `device`	Device approval flow; retired legacy mode returns FLY-416 guidance; default auto
`--base-url`	`URL`			Public Flywheel origin used for setup and MCP config
`--name`	`NAME`			MCP server name
`--force`				Switch from the other install mode: set up this mode first, then remove the other mode's setup

Install MCP wiring and bundled skills

npx --yes @paradigma-inc/flywheel setup --mode mcp --install-skill --codex

Configure Codex MCP wiring without bundled skills

npx --yes @paradigma-inc/flywheel setup --mode mcp --skip-skill --codex --project

Install CLI-mode bundled skills for Codex

npx --yes @paradigma-inc/flywheel setup --mode cli --codex --project