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.
wloop initThe steps
Section titled “The steps”- Prerequisites. It runs the checks of
wloop doctorthat need no daemon (ghand its login,git, the workspace managers, the agent). When one fails it stops and prints the fix. - Projects directory.
projects_diris wherewloop reviewclones a repository that no workspace manager knows yet. It suggests the common parent of the repositories they already have. - Agent. The coding agent that runs the rounds, detected from what is installed. Claude Code (
claude) is the one supported today. - 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 whatghknows about you. See the daemon. - 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.
- 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.
- Configuration file. It shows the diff against your current
config.tomland asks before overwriting it. - 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. - Doctor. It runs
wloop doctorand prints the next step: usually your first review.
Without questions
Section titled “Without questions”Every answer has a flag, so init runs in a script or a dotfiles setup:
wloop init \ --projects-dir ~/projects \ --agent claude \ --scope-repo acme/api --scope-team acme/backend \ --profile-default \ --skip-slack \ --yes| Flag | Answers |
|---|---|
--projects-dir <dir> | the projects directory |
--agent <name> | the agent |
--scope-repo, --scope-team, --scope-person | the scope, each repeatable |
--profile <dir> or --profile-default | a personal profile directory (created with example blocks when absent), or the bundled profile alone |
--slack-client-id <id> or --skip-slack | the Slack app’s client id, or leave Slack as it is |
--no-install | install into neither the agent homes nor the app |
--yes | yes to every confirmation: overwrite the configuration, install, app install |
The flag set may grow; see wloop init --help for the current one.
What it writes
Section titled “What it writes”~/.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 installandwloop app installwrite, when you accept them (see Install).
Every key it does not ask about keeps its default. The configuration reference lists them all.