Skip to content
workrex

setup

Copy page

Detects the agent CLIs on this machine, installs status tracking hooks for them, and installs the bundled skills. It shows each agent’s current state and asks before it changes anything.

Terminal window
workrex setup [--hooks | --skills]

Options

Section titled “Options”
FlagDescription
--hooksSet up only the status tracking hooks.
--skillsInstall only the skills.

Without a flag, setup does both.

What happens

Section titled “What happens”
  1. Detects the installed agent CLIs. If it finds none, it prints a hint and exits.
  2. Lists each agent’s hook status: configured, update available, not configured or error. For an update, it shows the diff.
  3. Asks Install or update status tracking hooks? and installs the hooks for each agent that needs them.
  4. Lists the bundled skills (merge, rebase, worktree, coordinator, open-pr and workrex) and the directory each agent reads skills from, then asks before it copies them.

Setup installs native workrex-status resources that call workrex. Claude Code hooks are merged into ~/.claude/settings.json, or its configured override, without removing unrelated integrations. An enabled Claude Code plugin whose ID starts with workrex-status@ is recognized as a Workrex integration.

Examples

Section titled “Examples”
Terminal window
# Set up hooks and skills
workrex setup


# Update only the status tracking hooks
workrex setup --hooks


# Install only the skills
workrex setup --skills

See also

Section titled “See also”