AIDE Documentação
Como trabalhar
no AIDE
Guias curtos do essencial: do primeiro uso aos seus próprios comandos para o agente.
Primeiros passos
AIDE is a desktop code editor with an AI studio built in: an agent, a design canvas and a team of twelve roles work in one window. Below is the short path from install to your first edit.
- Instale
Node.js 20+,Ruste os pré-requisitos do Tauri 2 para Windows. - Na pasta do projeto, rode
npm installe depoisnpm run tauri dev. - Abra a pasta do seu código: Ctrl+O.
- Conecte um modelo nas configurações. A chave de API fica no cofre de credenciais do Windows, não em arquivos.
- Describe the task in the chat on the right. The agent proposes a plan, asks permission for file writes and commands, and reports what it did together with the token count.
If you just use the installer, Node.js and Rust are not needed — everything is already inside.
Install and updates
The ready-made installer is on this site: the “Download for Windows” button in the Start section. You need Windows 10 or 11 and WebView2 — current builds already have it.
- Building from source.
npm install, thennpm run tauri build. The files land in thebundlefolder next to the project: an NSIS installer and an MSI package. - Updates arrive by themselves. Once a day AIDE compares its version with the latest GitHub release and offers to update. You can also check manually.
- Signature. Update files are checked against a cryptographic signature: the app will not trust a build from an outside source.
- Windows warning. The installer is not signed with a paid publisher certificate, so SmartScreen may ask for confirmation on first launch. It does not affect the editor itself.
- Uninstalling. The usual Windows uninstall. Your projects, settings and keys stay in place — remove them separately if you want to.
Workspace
The project tree is on the left. Files and folders are created, renamed and deleted from the context menu, and changes on disk are picked up right away: an outside edit is never lost.
- Tabs. They keep their cursor position and undo history and close with the middle mouse button. Images, PDFs and fonts open for preview right in the editor.
- Panels. Explorer, project search, Git, snippets and extensions switch in the left panel and stay out of each other's way.
- Text search. Ctrl+Shift+F searches by text, with case and file masks.
- Search by meaning. A query like “parse config file” finds the right places even when the code uses other words: function and path names count separately from plain text.
- Command palette. Ctrl+P — files and actions without the mouse.
Editor and languages
The editor is built on CodeMirror 6: highlighting, line numbers, completion, search and replace, multiple cursors and folding.
- Language servers. Type hints, error squiggles, go to definition and back, rename a symbol and format a file — the same servers VS Code uses.
- Works without a server. If no language server is installed for a language, highlighting, navigation and symbol search remain.
- Git conflicts. Shown as a merge view: accept your side or theirs with a button, no need to edit the file by hand.
- Agent edits. Ctrl+K on selected code — the agent proposes a new version and you accept or reject it by diff.
Chat and models
OpenAI, Anthropic, Google and any compatible server are supported: the address and the model list are set in the provider settings.
- Local models. Ollama or LM Studio on this computer — then requests never leave the machine.
- Keys. Stored in the Windows Credential Manager, separately per provider. A key never reaches the project, the model's reply or a log.
- Tokens. Every answer shows what it cost, so models can be compared by price rather than by feel.
- History. Lives in the project: come back to the folder and the conversation continues where it stopped.
- Attachments. Attach a file or an image to a message and its text joins the model's context.
- Queue. If the agent is still working, a new message waits in the queue; the arrow next to it sends it immediately and stops the current answer.
Três modos
O seletor no topo da janela muda toda a interface. O projeto, o histórico e o agente continuam os mesmos.
- IDE
- Um editor sobre o CodeMirror 6, árvore de arquivos, terminais em abas, Git e busca. O agente fica no chat à direita.
- Vibe
- Descreva o resultado com palavras. O team lead divide a tarefa em etapas, os papéis executam e o QA confere.
- Design
- Monte um mockup no canvas, depois clique em «Criar no projeto» e escolha o stack: HTML, React, Vue, Svelte, Next.js ou Astro.
Agente
- Permissões. Gravar arquivos e rodar comandos no terminal só depois do seu «Permitir».
- Relatório. Cada resposta termina com a lista de ações, por exemplo «Concluído: 6 ações ›», e o total de tokens gastos.
- Desfazer. Antes de qualquer edição é criado um checkpoint. O botão «Desfazer» restaura os arquivos alterados.
- Parar. Corta a requisição ao modelo na hora.
- Editar uma seleção. Selecione o código e pressione Ctrl+K: as mudanças aparecem como diff para aceitar ou rejeitar.
- Clarifications. When a task can be read in different ways, the agent asks first and then works — it does not decide for you.
Terminal and Git
- A real pty. Interactive programs, colours, arrows and Ctrl+C all work. As many terminal tabs as you need.
- Git panel. Changed files, a line-by-line diff, branch and history; commits are made from there too.
- Agent commands. It can run them, but only with your confirmation: you see exactly what is about to run.
Quality checks
- After edits. AIDE runs the project's checks — types, linter, tests — and reports back if something broke.
- Before “done”. The verify-before-done skill requires re-reading the diff, building the project and running the tests.
- Diagnostics. Language server errors show up in the panel immediately, before the project is even run.
- Turning off. Self-checks can be disabled in settings when a project is big and the checks take long.
Tripulação
- Doze papéis com rostos, vozes e habilidades: team lead, design, front, back, QA, DevOps, analista, advogado, contador, marketing, estagiário e piadista. Você é o CEO: define a tarefa, os papéis discutem e dividem o trabalho.
- Só os papéis com «mãos» podem alterar arquivos e rodar comandos — os demais aconselham e revisam. As ações deles passam pelas mesmas permissões do agente.
You are the CEO: you decide what of it makes it into the code.
Regras e comandos
Coloque AGENTS.md ou CLAUDE.md na raiz do projeto — o agente lê essas regras antes de trabalhar.
Seus próprios comandos de chat: crie um arquivo .aide/commands/nome.md com o prompt. Ele aparece no chat como /nome, e $ARGUMENTS é trocado pelo que você escrever depois do comando.
Project rules beat the agent's habits: if a file forbids changing something, the agent asks instead of doing it silently.
Security and data
- Keys. In the Windows Credential Manager. Not in the project, the repository or the logs.
- Permissions. File writes, commands and network access only after confirmation.
- Your code. Stays on disk: AIDE sends it only to the model you chose.
- A local model. Then nothing leaves the computer at all.
- No telemetry. The app collects no usage statistics and sends no hidden reports.
Settings
- Appearance. Interface language, theme, editor font size, panel and terminal behaviour.
- Providers. A fixed model list for servers that cannot list models themselves.
- Skills. Built-in rule sets can be switched on and off: verify before done, careful changes, secure code, debugging, tests, frontend.
- Permissions. What the agent may do without asking and what always needs a confirmation.
Atalhos de teclado
| Ctrl+O | Abrir uma pasta de projeto |
| Ctrl+S | Salvar o arquivo |
| Ctrl+W | Fechar a aba |
| Ctrl+P | Paleta de comandos |
| Ctrl+R | Projetos recentes |
| Ctrl+B | Mostrar ou ocultar a barra lateral |
| Ctrl+J | Mostrar ou ocultar o terminal |
| Ctrl+Shift+F | Buscar no projeto |
| Ctrl+Shift+G | Painel do Git |
| Ctrl+K | Pedir ao agente para editar o código selecionado |
| Esc | Fechar a paleta, as configurações ou a edição |
Frequently asked questions
- Do I need Node.js and Rust just to use AIDE?
- No. The installer already contains everything the app needs. Node is only needed for checks in your own project, and Rust only if you build AIDE yourself.
- Where does my code go?
- Only to the model you chose. With a local model it goes nowhere.
- Where are API keys stored?
- In the Windows Credential Manager, encrypted, separately for each provider.
- Can I work without internet?
- Yes, with a local model: the editor, terminal and Git always work, and the agent works with the local model.
- What if the agent makes a mistake?
- A checkpoint is taken before edits and Undo restores the files. Permissions stop it from doing anything without your consent.
- Does AIDE run on macOS or Linux?
- The build is for Windows today. The Tauri and React code is portable, but there are no ready builds for other systems.
- How do I update?
- By itself: the app checks for an update and offers to install it. Or download the new installer from this site.
- Why does Windows warn when installing?
- The installer is not signed with a paid publisher certificate — that is a SmartScreen warning, not a virus. Update signatures are verified separately.
When something does not work
- The model does not answer. Check the key and the provider address in settings and your internet access. Error 401 means a wrong key, 429 means a rate limit.
- It will not install. Close the running AIDE and try again.
- Panels disappeared. Ctrl+B and Ctrl+J bring back the side panel and the terminal.
- The terminal is empty. Open a new terminal tab — the old session may have ended.
- No highlighting or hints. A language server may be missing for that language: install it in the system and the editor picks it up.
- Checks fail. Paste the check output into the chat — the agent reads the error and fixes the cause, not the symptom.