GearMod — Multi-Agent Development Workspace

The problemO problema

Coding agents are fast. Running them is messy.Agentes de código são rápidos. Operá-los é bagunçado.

The agent is rarely the bottleneck. The mess around it is: shared folders, missing plans and reviews nobody can trace.O gargalo raramente é o agente. É a bagunça em volta dele: pastas compartilhadas, falta de plano e revisões que ninguém consegue rastrear.

They step on each otherEles pisam um no outro

Two agents in the same checkout overwrite each other's files and mix up branches. You end up with a half-working tree to untangle by hand.Dois agentes no mesmo checkout sobrescrevem os arquivos um do outro e misturam as branches. Você acaba com uma árvore pela metade para desembaraçar na mão.

With GearModCom o GearModOne Git worktree and branch per card. Agents work in parallel and your main checkout is never touched.Uma worktree e uma branch Git por card. Os agentes trabalham em paralelo e o seu checkout principal nunca é tocado.

They start without a planComeçam sem plano

A vague prompt turns into a large diff you never asked for. You only learn what the agent understood after it has already written the code.Um prompt vago vira um diff enorme que você não pediu. Você só descobre o que o agente entendeu depois que ele já escreveu o código.

With GearModCom o GearModEach card gets a summary, spec, plan and tasks first. While planning, the agent can only read code, and risky choices wait for your approval.Cada card começa com resumo, spec, plano e tarefas. No planejamento o agente só lê código, e escolhas de risco esperam a sua aprovação.

Review is scatteredA revisão fica espalhada

Chats in one window, terminals in another, branches everywhere. Nobody remembers what was tested or which commit belongs to which task.Chats numa janela, terminais em outra, branches por todo lado. Ninguém lembra o que foi testado nem qual commit pertence a qual tarefa.

With GearModCom o GearModEvery commit is tagged with its card, a separate test step records what passed and what was skipped, and diffs, conflicts and PRs live on one Git page.Cada commit leva o card a que pertence, uma etapa de teste separada registra o que passou e o que foi pulado, e diffs, conflitos e PRs ficam numa só página Git.

FeaturesRecursos

Everything between an idea and a merged PRTudo entre a ideia e o PR mesclado

Plan with the agent, let it implement, test in a separate step, then review and ship from the same window.Planeje com o agente, deixe-o implementar, teste numa etapa separada e revise e entregue na mesma janela.

Plan before codePlaneje antes do código

Summary, spec, plan and task list per card
Planning, implementation and testing as separate steps
Spec-driven flows, Spec Kit and a project Constitution

Resumo, especificação, plano e tarefas por card
Planejamento, implementação e teste em etapas separadas
Fluxos spec-driven, Spec Kit e Constitution do projeto

Run agents safelyAgentes com segurança

One Git worktree and branch per card
Minimal environment; risky actions ask first
Secret scan blocks agent commits with keys

Uma worktree e branch Git por card
Ambiente mínimo; ações de risco pedem permissão
Scan de segredos bloqueia commits de agente com chaves

Review and shipRevise e entregue

Full Git client: graph, diffs, conflicts, rebase
GitHub and GitLab pull requests
Editor, terminal and file explorer built in

Cliente Git completo: grafo, diffs, conflitos, rebase
Pull requests do GitHub e GitLab
Editor, terminal e explorador de arquivos integrados

Tools for the agentsFerramentas para os agentes

Local MCP server: agents update their card and ask you questions
Local code index with symbol search
Skills picked with / in any chat

Servidor MCP local: agentes atualizam o card e fazem perguntas
Índice de código local com busca de símbolos
Skills escolhidas com / em qualquer chat

Smart workflow choiceEscolha de fluxo inteligente

Each card is scored on six dimensions
Short flow, light spec or full SDD recommended
You decide; every assessment is versioned

Cada card recebe nota em seis dimensões
Fluxo curto, spec leve ou SDD completo recomendado
Você decide; toda avaliação é versionada

Optional extrasExtras opcionais

Voice dictation (local whisper.cpp or Groq)
PostgreSQL manager (experimental)
Playwright CLI for the tester agent

Ditado por voz (whisper.cpp local ou Groq)
Gerenciador de PostgreSQL (experimental)
Playwright CLI para o agente de teste

Specs, plans and tasks live on the cardSpecs, planos e tarefas ficam no card

The plan is saved as Markdown documents with version history. Edit anything before you start; the agent ticks tasks off as it goes.O plano é salvo como documentos Markdown com histórico de versões. Edite o que quiser antes de começar; o agente vai marcando as tarefas.

A card with its specification, plan and tasks

A card from start to finishUm card do início ao fim

Plan. Implement. Test. Merge.Planeje. Implemente. Teste. Mescle.

Screenshots from a real run: three cards on a sample finance app, planned, implemented and tested by Codex inside GearMod.Capturas de uma execução real: três cards num app de finanças de exemplo, planejados, implementados e testados pelo Codex dentro do GearMod.

PlanPlanejar

The agent reads code only, scores the card and proposes a workflow.O agente só lê código, dá nota ao card e propõe um fluxo.

Read the docsLer os documentos

Spec, plan and tasks saved with version history.Spec, plano e tarefas salvos com histórico de versões.

ImplementImplementar

A worktree and branch are created; tasks tick off live.Worktree e branch são criadas; as tarefas são marcadas ao vivo.

TestTestar

A separate agent runs its own checklist and reports what it couldn't check.Outro agente roda seu checklist e relata o que não conseguiu checar.

Review & mergeRevisar e mesclar

Diffs on the Git page, then merge or open a PR.Diffs na página Git; depois, merge ou PR.

Questions show up as choicesPerguntas viram escolhas

The agent asks in the chat and changing the workflow waits for your approval. Nothing moves until you answer.O agente pergunta no chat e trocar o fluxo espera a sua aprovação. Nada anda até você responder.

The planning chat recommends the full SDD and asks which workflow to use

Implementation you can followImplementação que você acompanha

Tasks are ticked in the side panel and changed files appear below. When it's done, the agent asks to commit: authorize, edit the message or deny.As tarefas são marcadas no painel lateral e os arquivos alterados aparecem abaixo. Ao terminar, o agente pede para commitar: autorize, edite a mensagem ou negue.

The implementation chat with all tasks done and the agent asking to commit

A tester that tells you what it skippedUm testador que diz o que pulou

The test step records what passed and what it could not check, so you know where to look yourself.A etapa de teste registra o que passou e o que não conseguiu checar, para você saber onde olhar.

Not every card needs a full specNem todo card precisa de uma spec completa

The planning agent scores each card from 0 to 3 on six weighted dimensions, with evidence. GearMod recommends a workflow; you make the final call.O agente de planejamento dá nota de 0 a 3 ao card em seis dimensões com peso, com evidências. O GearMod recomenda um fluxo; a decisão final é sua.

ScoreTotal	LevelNível	WorkflowFluxo
0–7	SimpleSimples	Short flowFluxo curto
8–16	MediumMédio	Light specSpec leve
17+	ComplexComplexo	Full SDD

Dimensions: scope, coupling, uncertainty, risk, technical novelty and validation difficulty. A card with risk 3 never gets the short flow. Weights and limits are configurable per project.Dimensões: escopo, acoplamento, incerteza, risco, novidade técnica e dificuldade de validação. Card com risco 3 nunca recebe o fluxo curto. Pesos e limites são configuráveis por projeto.

The assessment dialog: 24 points, complex, with a justification for each dimension

Git

A full Git client, built around cardsUm cliente Git completo, feito em torno dos cards

Commit graph with branch, tag and worktree labels. Agent commits carry the agent's icon and the card they belong to.
Grafo de commits com rótulos de branch, tag e worktree. Commits de agentes levam o ícone do agente e o card.
Conflicts resolved block by block: current, incoming or both.
Conflitos resolvidos bloco a bloco: atual, recebido ou ambos.
Everything you expect: rebase, cherry-pick, revert, reset, stash, amend, and undo/redo for most operations.
Tudo o que você espera: rebase, cherry-pick, revert, reset, stash, amend e desfazer/refazer na maioria das operações.
Agent commits need permission, with rules per branch. By default agents ask, and never commit to main, develop or release/*.
Commits de agentes pedem permissão, com regras por branch. Por padrão eles perguntam e nunca commitam em main, develop ou release/*.
Pull requests for GitHub and GitLab: list, read, comment, approve and create.
Pull requests do GitHub e GitLab: listar, ler, comentar, aprovar e criar.

The Git page: commit graph with branches and worktrees per card

Code indexÍndice de código

Agents read less to find the right codeAgentes leem menos para achar o código certo

GearMod keeps a local map of your code: functions, classes, calls, imports and tests. Agents query it before opening files. Built with tree-sitter in a background process, stored on your machine.O GearMod mantém um mapa local do seu código: funções, classes, chamadas, imports e testes. Os agentes consultam o mapa antes de abrir arquivos. Feito com tree-sitter em segundo plano, salvo na sua máquina.

TypeScript, JavaScript, Python, Go, Java, C#, Rust, PHP, Ruby, C/C++
TypeScript, JavaScript, Python, Go, Java, C#, Rust, PHP, Ruby, C/C++
“Which tests does this change affect?” answered by the index
“Quais testes essa mudança afeta?” respondido pelo índice
Editor shortcuts: Ctrl+T, F12, Shift+F12
Atalhos no editor: Ctrl+T, F12, Shift+F12

The code index section in the project settings

Database · experimentalBanco de dados · experimental

Check the data your cards changeConfira os dados que seus cards alteram

A PostgreSQL client inside the project. Each connection has a class (dev, test, prod, external); prod and external start read-only, and risky SQL asks for confirmation.Um cliente PostgreSQL dentro do projeto. Cada conexão tem uma classe (dev, test, prod, external); prod e external começam somente leitura e SQL de risco pede confirmação.

The database view: connection tree, a SQL tab and a table with paging

Under the hoodPor dentro

Your machine, your agents, your accountsSua máquina, seus agentes, suas contas

Card→Git worktree + branch→Claude Code / Codex CLI→MCP server (card · questions · commits)↩

WorktreesWorktrees

Each card gets its own folder and branch, so several agents work at once without stepping on each other or on your checkout.Cada card tem sua própria pasta e branch, então vários agentes trabalham ao mesmo tempo sem atrapalhar uns aos outros nem o seu checkout.

Your agentsSeus agentes

GearMod starts the CLIs you already have installed, with your sign-in and plan. It does not proxy or resell model access.O GearMod inicia as CLIs que você já tem instaladas, com seu login e plano. Não faz proxy nem revende acesso a modelos.

Your dataSeus dados

Everything lives under %APPDATA%\GearMod. GearMod sends nothing anywhere; optional features reach the network only when you turn them on. It is not a sandbox: see SECURITY.md.Tudo fica em %APPDATA%\GearMod. O GearMod não envia nada para lugar nenhum; recursos opcionais só usam a rede quando você liga. Não é um sandbox: veja o SECURITY.md.

Download

Get GearMod for WindowsBaixe o GearMod para Windows

Every version published on GitHub appears here automatically.Toda versão publicada no GitHub aparece aqui automaticamente.

GearMod for Windows

Windows 10 or 11, 64-bit · per-user install, no admin rightsWindows 10 ou 11, 64 bits · instalação por usuário, sem admin

Download installerBaixar instalador View repositoryVer repositório Release notesNotas da versão

Not code-signed yet. Windows SmartScreen may show “Windows protected your PC”. Click More info, then Run anyway. You can verify the download against SHA256SUMS.txt from the same release.Ainda sem assinatura de código. O SmartScreen do Windows pode mostrar “O Windows protegeu seu PC”. Clique em Mais informações e depois em Executar assim mesmo. Você pode conferir o download com o SHA256SUMS.txt da mesma release.

Before you installAntes de instalar

Windows 10 or 11, 64-bit. Other platforms are not supported yet.
Windows 10 ou 11, 64 bits. Outras plataformas ainda não são suportadas.
Git installed.instalado.
At least one agent CLI, installed and signed in: Claude Code or Codex.
Ao menos uma CLI de agente instalada e logada: Claude Code ou Codex.
To update, install the new version over the old one. Your data is kept.
Para atualizar, instale a nova versão por cima. Seus dados são mantidos.

All versionsTodas as versões

FAQ

QuestionsPerguntas

Is GearMod open source?O GearMod é open source?

It is source-available under the PolyForm Shield License 1.0.0. You can read, use, modify and redistribute the code, including inside a company, but you cannot use it to offer a product that competes with GearMod. It is not an OSI-approved open source license.

É source-available, sob a PolyForm Shield License 1.0.0. Você pode ler, usar, modificar e redistribuir o código, inclusive dentro de uma empresa, mas não pode usá-lo para oferecer um produto concorrente do GearMod. Não é uma licença open source aprovada pela OSI.

Does it cost anything?Tem custo?

GearMod is free to use. The agents use your own Claude or OpenAI plan.

O GearMod é gratuito. Os agentes usam o seu próprio plano da Claude ou da OpenAI.

Does it work on macOS or Linux?Funciona em macOS ou Linux?

Not yet. Windows is the only supported platform for now.

Ainda não. Por enquanto, só Windows.

Which agents are supported?Quais agentes são suportados?

Claude Code and Codex. Gemini CLI support exists but is disabled for now.

Claude Code e Codex. O suporte ao Gemini CLI existe, mas está desativado por enquanto.

Does GearMod send my code anywhere?O GearMod envia meu código para algum lugar?

GearMod itself sends nothing. The agent CLIs you use talk to their own providers under your account, as they always do. Optional features (like Groq dictation) reach the network only when you enable them.

O GearMod em si não envia nada. As CLIs de agente que você usa falam com seus próprios provedores, na sua conta, como sempre. Recursos opcionais (como o ditado via Groq) só usam a rede quando você os ativa.

Can I contribute?Posso contribuir?

Outside pull requests are not accepted yet; bug reports and suggestions are welcome as GitHub issues.

Pull requests externos ainda não são aceitos; relatos de bugs e sugestões são bem-vindos como issues no GitHub.

Run many coding agents at once.
Without the chaos.Rode vários agentes de código ao mesmo tempo.
Sem bagunça.