للمستخدمين · البدء
الخطوات الأولى
هذه الصفحة غير متاحة بعد باللغة العربية. أنت تقرأ النسخة الإنجليزية.
Gitoodo is an orchestrator for your repositories: you describe what you want to build, Gitoodo turns it into issues and lets coding agents (Claude Code, Codex or Gemini CLI) work on them as workers until the pull requests are merged. Direct mode is the lighter alternative: it only collects what is waiting for you. This page takes you from installation to the first worker.
What you need#
- A Mac with Apple Silicon, or Windows 10/11 (x64).
- An account on Forgejo, Gitea, GitHub or GitLab, self-hosted works too.
- For the orchestrator: an agent CLI you already use and are signed in to (Claude Code, Codex or Gemini CLI). Workers run under your own subscription; Gitoodo needs no API key.
Install#
لم يُطرح Gitoodo بعد. ستعمل هذه الأوامر بدءًا من الإصدار الأول.
macOS (Apple Silicon). One line in Terminal downloads the signed and notarized release, checks its SHA-256, installs Gitoodo to /Applications (or ~/Applications), links the gitoodo command into ~/.local/bin and opens the app. Running it again updates in place; it needs no sudo.
curl -fsSL https://gitoodo.com/install.sh | bashTo remove Gitoodo completely (app, command, services, settings, caches, logs, stored tokens, the agent skill and privacy permissions):
curl -fsSL https://gitoodo.com/uninstall.sh | bashIt asks before it deletes repositories Gitoodo cloned and never touches your own checkouts; --dry-run only shows what it would remove.
Windows 10/11 (x64). One line in PowerShell reads the release, checks the setup's SHA-256 and its publisher (the code signature), installs Gitoodo for your user only to %LOCALAPPDATA%\Gitoodo, puts the gitoodo command on your PATH and opens the app. Running it again updates in place; it needs no admin rights.
irm https://gitoodo.com/install.ps1 | iexWhile a release's Windows installer is not signed yet, the command stops before it installs anything and says so; download the setup .exe from the download section instead. Windows SmartScreen then warns about an unknown publisher: choose More info, then Run anyway.
To remove Gitoodo completely (app, command, background task, settings, caches, logs, stored tokens in Credential Manager, autostart and the agent skill):
irm https://gitoodo.com/uninstall.ps1 | iexLike on macOS it asks before it deletes repositories Gitoodo cloned and never touches your own checkouts. Options go after the script, for example & ([scriptblock]::Create((irm https://gitoodo.com/uninstall.ps1))) -DryRun. You can also download the setup .exe from the project's Releases page and run it; check the publisher before you approve a system prompt.
From source. With Rust, Node.js and the Tauri 2 prerequisites installed, npm ci and npm run tauri build build the installers for the current system; see Building.
The introduction#
On first start Gitoodo walks you through a short introduction. You can skip any step and repeat the whole introduction later under Help & Feedback → Getting started.
- Language. Gitoodo follows the system language; Settings → General changes it.
- How should Gitoodo work? Choose Orchestrator (recommended) or Direct. You can switch at any time under Settings → Mode.
- Connect your forge. Enter the server address and a token. The token assistant asks what Gitoodo should do with your repositories (preselected from the mode you just chose), opens your forge's token page and lists every permission the token needs for that in one block, with its reason and the role your account needs. Confirm that you set these permissions, paste the token and click Check. The token goes to the system secret store (macOS Keychain, Windows Credential Manager), never into a file or a log.
- Repos. Switch on the repositories Gitoodo should read. Switched-off repositories are not queried at all.
- Set up the orchestrator (orchestrator mode only). Gitoodo sets up every repository you just picked the same way: labels, switching on and a local copy, plus the background service, the skill and the dispatcher.
- Notifications. Allow notifications, so Gitoodo can tell you when a decision is waiting, even with the window closed.
- Start and shortcut. Decide whether Gitoodo starts at login and which keyboard shortcut opens it from any app.
- Usage statistics. The last step shows the anonymous usage statistics with what they send; you can switch them off there. Nothing is sent before you finish the introduction.
Gitoodo then lives in the macOS menu bar or the Windows notification area as a check mark. When the check mark turns red, something is waiting for you.
Orchestrator mode first#
If you chose the orchestrator, the introduction ends with the setup assistant. It checks each part of the setup right away and does what is missing:
- the background service (
gitoodo service install: launchd, a systemd user unit or a scheduled task), - the status labels in each repository,
- switching the repository on for orchestration and a local working copy,
- the agent instructions and the optional
gitoodo-questionsskill, - the dispatcher, which starts the workers, and a check that your agent CLI is installed and signed in.
You can open the assistant again under Settings → Mode with Start setup; every step also works by hand, see Orchestrator setup.
From then on the work goes like this:
- Get issues into the repository, either way: describe your plan in the Chat tab, and the orchestrator suggests repositories and issues and creates them only after your click; or write issues yourself, on the forge or with New issue on the Board. Gitoodo treats both alike.
- The dispatcher starts one worker per ready issue, each in its own worktree and branch. The Board shows what is in flight and lets you look into any worker.
- When a worker needs a decision, it asks in its issue. The question appears under Asked of me as an answer card with the recommendation preselected.
- Finished pull requests are merged in the style your repository allows; see Merge and release.
The store version for the Mac App Store has no orchestrator: its sandbox allows no background services and no workers. The orchestrator comes with the direct download.
Direct mode#
Direct mode needs nothing but an account. Gitoodo polls your forges from the app and shows what waits for you across repositories and accounts: questions in issues, assigned issues, review requests and status labels, with the tray counter and notifications. It does not start workers and leaves labels alone. Both modes read the same issues, so you can start in direct mode and switch to the orchestrator later under Settings → Mode.
Next steps#
- Daily use: the four tabs and how a day with Gitoodo looks.
- Questions: how agents ask and how you answer.
- Settings: every setting in one place.
- Troubleshooting and the FAQ if something does not work.