francieloliveira/tuttidash

Run several AI coding agents in parallel on a Linear backlog, and keep an eye on them from the Mac notch.
TuttiDash is the set of local tools that TranscentIA uses to work
through a Linear project with coding agents in parallel lanes: one card, one git worktree and one
agent per lane at a time. It is shared as-is, as a working example. It was built for one developer's
Mac and workflow, and it shows. The app UI and most of the docs are in Brazilian Portuguese.
Leia em português.
## What's inside
| Part | Where | What it does |
| Dispatcher | lanes/dispatcher.py | Every 60 s it takes a ready card from the Linear project, creates a worktree and runs the agent headless in tmux (Claude Code, Codex, OpenCode, DeepSeek Harness, Grok CLI…). It pushes and opens a draft PR. The card moves to In Review only after the remote check prova-remota is green on the full head SHA. A local proof or a DONE comment is not authority. Timeout or error calls the owner. The agent itself never talks to Linear or GitHub. |
| Watcher | bots/watch.py | Merges when the remote proof is green and the [Revisor] approved the head (plus the revisao-ia check, when the project's main has that workflow), triages stopped or failed lanes and calls the owner (needs:dono) when a review secret or a repeated failure needs a person. The AI review runs on GitHub Actions, not in this process. |
| Notch app | apps/notch-mac | SwiftUI/AppKit app in the notch and menu bar: lanes, builds, tests, deliveries, cost from the lane logs, account limits where an official source exists, and the settings. |
| gasto CLI | gasto.py, gasto_lanes/ | Cost ledger built from the lane logs, by day, week, card and lane. See docs/gasto.md. |
| Agent catalog | agents.d/.json | One manifest per agent (CLI, cost type, models per effort, review command). Python and Swift read the same files. |
| Brainstorm | brainstorm.html | Tela interativa para discutir ideias com agente, gerar user stories e inserir cards no Linear (via proxy). |
## Before you use it
macOS only (14 or newer). Personal project: expect rough edges. Issues are welcome; there is no support promise.
It runs agents unattended with your accounts. They edit code, run commands and spend money or quota.
Try it on a throwaway project first, keep every lane disabled until a dry run looks right, and set
budgets (lanes.budget_usd) and protected paths (protegidos).
The check prova-remota is the remote proof for merging into main; branch protection has to require it. It does not stop a lane from reading ~/.ssh or ~/.config/gh.
Account limits come only from official or local sources: the GitHub Copilot billing API and the local
OpenCode session database. Claude Code, Codex, Grok and Gemini subscriptions have no official public
quota API, so TuttiDash does not show their limits. The reading engine is pluggable (FonteUso, see
apps/notch-mac/README.md).
It never renews or rewrites another tool's credentials. It reads logs, its own state and its own config.
The Linear API key lives in the app Keychain (data protection). Scripts do not read it.
## Requirements
macOS 14+ and Xcode 16+ (Swift toolchain)
Python 3.9+ (standard library only), git, the GitHub CLI (gh auth login) and tmux