Skip to content

Set up with init

wloop init takes you from a fresh install to a working loop. At a terminal it asks one question per step and suggests an answer for each. It is safe to run again: the current configuration supplies the defaults, so a second run is how you change an answer.

Terminal window
wloop init
  1. Prerequisites. It runs the checks of wloop doctor that need no daemon (gh and its login, git, the workspace managers, the agent). When one fails it stops and prints the fix.
  2. Projects directory. projects_dir is where wloop review clones a repository that no workspace manager knows yet. It suggests the common parent of the repositories they already have.
  3. Agent. The coding agent that runs the rounds, detected from what is installed. Claude Code (claude) is the one supported today.
  4. Scope. What the daemon follows besides your own pull requests and your review requests: repositories (plugins.github.scope.repos), people (plugins.github.scope.people) and teams (plugins.github.scope.teams). It suggests them from what gh knows about you. See the daemon.
  5. Profile. Either the bundled default profile alone, or a personal profile directory. A new directory is created with a commented example block for each intent, ready to edit. See Write your review profile.
  6. Slack (optional). Guided or skipped. The guided step walks you through creating the Slack app from the manifest, asks for the client id and the app-level token, and runs the OAuth login. See Connect Slack.
  7. Configuration file. It shows the diff against your current config.toml and asks before overwriting it.
  8. Install. It offers wloop install (the agent homes) and, on macOS, wloop app install (the menu bar app and the LaunchAgents), each after a confirmation.
  9. Doctor. It runs wloop doctor and prints the next step: usually your first review.

Every answer has a flag, so init runs in a script or a dotfiles setup:

Terminal window
wloop init \
--projects-dir ~/projects \
--agent claude \
--scope-repo acme/api --scope-team acme/backend \
--profile-default \
--skip-slack \
--yes
FlagAnswers
--projects-dir <dir>the projects directory
--agent <name>the agent
--scope-repo, --scope-team, --scope-personthe scope, each repeatable
--profile <dir> or --profile-defaulta personal profile directory (created with example blocks when absent), or the bundled profile alone
--slack-client-id <id> or --skip-slackthe Slack app’s client id, or leave Slack as it is
--no-installinstall into neither the agent homes nor the app
--yesyes to every confirmation: overwrite the configuration, install, app install

The flag set may grow; see wloop init --help for the current one.

  • ~/.config/wloop/config.toml (or under $XDG_CONFIG_HOME), only after you confirm the diff;
  • the profile directory you chose, when it does not exist yet;
  • what wloop install and wloop app install write, when you accept them (see Install).

Every key it does not ask about keeps its default. The configuration reference lists them all.