Documentation Docs version: dev (Pre-release: Gitoodo has not been released yet)

For users · Reference and help

Settings

On this page
  1. All settings
  2. Accounts & repositories
  3. AI agents
  4. Orchestration
  5. Notifications & feedback
  6. General

The gear at the top right opens the settings. Search settings finds any setting by keyword.

Accounts & repositories
Accounts, repositories, views, sync
AI agents
AI assist, skills
Orchestration
Mode, dispatcher, automations, worker machines
Notifications & feedback
Notifications, chat, rating
General
Language, appearance, shortcut, backup, help, about

All settings#

Accounts & repositories#

Settings → Accounts & repositories · Accounts, repositories, views, sync

Accounts
Repos
Gitoodo no longer polls repos that are switched off.
Views
Views with a counter show up in the menu bar and are synced.

Add account and renewing a token open the token wizard. It first asks What should Gitoodo do with your repositories? with Answer questions, Work directly or Orchestrator, preselected from your operating mode. Then it lists, in one block, every permission the token needs for that choice: one row per permission with what it is for, Everything else (leave it unticked) and Your account’s role in the repository, which is granted in the repository’s collaborator settings, not on the token. On GitHub it covers classic and fine-grained tokens. The wizard continues only after you tick I have set these permissions on the token; permissions the forge reports missing are marked missing.

AI agents#

Settings → AI agents · AI assist, skills

AI assist
Chat with your own AI agent: Claude Code, Gemini CLI or Codex.
Skills
The skill “gitoodo-questions” teaches Claude Code / Codex to ask questions in the Gitoodo format.

Orchestration#

Settings → Orchestration · Mode, dispatcher, automations, worker machines

Mode
Who polls the forges and keeps the labels.
Dispatcher
Controls how the dispatcher works through issues.
Automations
Starts a Claude Code session on a schedule, but only when the precheck finds something. A run without a hit costs nothing.
Worker machines
This machine always runs workers. The dispatcher starts workers on other machines over SSH; Gitoodo uses your system ssh, and a password lives only in the system keychain.
Overview Advanced
When an issue counts as stale and which of your own labels stand for which status. Changes apply right away.

Notifications & feedback#

Settings → Notifications & feedback · Notifications, chat, rating

Notifications
System notifications when something new arrives.
Chat notification
Reports new questions to a chat. The webhook URL is kept in the keychain only and is never shown.
Weekly review
A short look back once a week: questions answered, answer time, merges. Computed locally only.
Ask for a rating
Now and then, after Gitoodo has helped you for a while, it opens the system's rating dialog. Gitoodo itself sends nothing.

General#

Settings → General · Language, appearance, shortcut, backup, help, about

Language
Applies to all texts of Gitoodo.
Appearance
Light or dark – or automatic, following the system setting.
Sidebar: remember the last state
Off: the repository sidebar starts fully collapsed. On: it opens the way you left it.
Shortcut
Opens Gitoodo from anywhere. Click the field and press the key combination.
Start at login
Gitoodo starts in the background after login and shows up in the menu bar.
When quitting
What happens to the background services when you quit Gitoodo. They run again at the next app start while the orchestrator is switched on.
Usage statistics
On by default. Sends anonymous usage numbers (which steps, views and features are used, app version, system, language) without cookies to our own server in the EU. Never repo names, contents or tokens. Switching off stops sending at once.
Back up and load
Saves the settings to a file or loads them from one. Tokens are never in the file.
Help & Feedback
About Gitoodo
Window size Advanced
Drag an edge or corner of the window to make it larger.
Log Advanced
Errors and events for troubleshooting. Tokens are never included.
Docs version: dev