For users · Reference and help
Settings
On this page
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.
- 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.