Início rápido
O FiboCode constrói no editor uma base de conhecimento a partir de código, documentação e grafos. Essa base cresce junto com o código, e o FiboCode compartilha esse contexto com o Agent CLI que você escolher, para que você e seus agentes possam compreender, navegar e alterar o código juntos.
A compreensão cresce junto com o código.
No dia a dia, isso aparece em duas formas de uso — uma para escrever e outra para ler:
| Uso | O que você faz | O que o FiboCode acrescenta |
|---|---|---|
| Fluxo de terminal aprimorado | Programar com o Agent CLI em que você já confia | Contexto ciente do workspace, alterações de arquivos registradas automaticamente e revisão hunk a hunk com qualidade de IDE |
| Análise e compreensão de código | Assumir um repositório desconhecido ou descobrir por que um sistema se tornou o que é | Documentos explicativos de todo o repositório, grafos conceituais e saltos bidirecionais entre código, texto e grafo |
Os dois caminhos começam da mesma forma: instale o aplicativo, abra um workspace e configure um modelo.
Baixar e instalar
Obtenha o instalador mais recente na página de versões do FiboCode:
| OS | Pacote |
|---|---|
| macOS (Apple Silicon) | Imagem de disco .dmg |
| Windows | Instalador .exe |
| Linux | .AppImage |
- macOS: abra o
.dmge arraste o FiboCode para Applications. - Windows: execute o instalador
.exee siga as instruções.
O botão Download da página inicial sempre aponta automaticamente para a versão mais recente, então você nunca precisa procurar números de versão.
Antes de começar
1. Abra um workspace. Clique em “Open Folder” no painel do workspace e escolha seu código, ou arraste uma pasta diretamente para o painel. Arrastar um arquivo .zip não é compatível; “Recently Opened” permite alternar entre workspaces depois. O FiboCode trata o repositório, não um único arquivo, como a unidade de compreensão.
2. Configure um modelo. Acesse System Config → Model Config → Add Provider e preencha Provider Name, Interface Type (compatível com OpenAI), Base URL, API Key e Model Name; depois de salvar, marque Main Model. Marque um provedor de baixa latência como Fast Model para que chamadas sensíveis à latência deem preferência a ele. Advanced Settings inclui concorrência, tempo limite e máximo de tokens de saída.
Quando um modelo está configurado, três recursos ganham vida:
- Resumos de diff — passe o cursor sobre um arquivo ou diretório no painel de controle de código-fonte para obter um resumo imediato do que mudou e gerar uma mensagem de commit com um clique antes de confirmar.
- Conclusão de código — o painel de sugestões de AI no editor, com cada sugestão aceita ou rejeitada individualmente.
- Análise de código — análise de todo o repositório que produz documentos explicativos e grafos conceituais por diretório e arquivo.
3. Instale Fibo Skills para o seu agente (opcional, recomendado). Fibo Skills adicionam ao Agent CLI do terminal um fluxo spec → plan → execute → sync e orientam o agente a gravar especificações, planos e registros de mudanças no sistema de documentos .fibo/. O FiboCode não cria automaticamente esse histórico de evolução; instale e use Fibo Skills se quiser que o agente o mantenha. Consulte Fibo Skills para instalar.
Uso 1: o fluxo de terminal aprimorado
Continue usando o Agent CLI em que já confia e não mude seus hábitos — o FiboCode apenas completa o contexto e a revisão ao redor dele.
- Mude para o modo CLI e comece a programar. Passe o painel de chat para o modo CLI, abra o terminal e execute Claude Code, Codex ou o Agent CLI que preferir.
- Volte ao modo de chat para consolidar as alterações. Quando a sessão terminar, volte e o FiboCode contabilizará todos os arquivos tocados no período, listando-os no changed files card — sem precisar reconstruir de memória ou com
git statuso que o agente realmente fez. - Faça uma revisão rápida. Clique em Review no cartão: leia o diff hunk a hunk, aceite ou rejeite cada bloco, ou trate um arquivo inteiro de uma vez. Snapshots permitem voltar a um estado anterior do arquivo.
- Faça o commit. Abra Source Control, prepare as alterações, gere ou escreva a mensagem de commit e confirme.
Uso 2: analisar e compreender código
Ler um repositório não significa abrir todos os arquivos do início ao fim — significa deixar o código descrever sua própria estrutura.
- Configure o escopo e os modelos. Acesse System Config → Code Analysis:
- Directory Blacklist — os nomes de diretório são comparados exatamente; um diretório correspondente e tudo dentro dele são excluídos (
node_modules,dist, …). - Extension Whitelist — apenas arquivos cuja extensão corresponde à lista permitida de código ou configuração são analisados.
- Analysis Templates — os modelos Directory, Code File e Configuration File são editados separadamente e definem a estrutura das explicações geradas; cada um pode ser restaurado ao conteúdo original.
- Directory Blacklist — os nomes de diretório são comparados exatamente; um diretório correspondente e tudo dentro dele são excluídos (
- Inicie a análise. De volta ao painel do workspace, clique em Analyze para executar a análise de todo o repositório. Diretórios e arquivos são analisados em paralelo, limitados pela concorrência da configuração do modelo; você pode cancelar a qualquer momento e será avisado quando terminar.
- Leia as explicações. Clique em qualquer diretório ou arquivo e a visualização Document à direita mostrará sua explicação; alterne para Graph para ver o grafo conceitual daquele ponto. Notas de diretório respondem “o que esta camada faz”; notas de arquivo respondem “como este arquivo faz isso”.
- Siga as tags. As tags code / text / graph em uma explicação são âncoras clicáveis: code leva ao arquivo-fonte e intervalo de linhas, text ao documento vinculado e graph ao grafo conceitual correspondente. Onde quer que você esteja lendo, código e explicação permanecem acessíveis entre si.
Próximos passos
- Fibo Skills — consulte o guia de skills para saber o que cada skill faz e como instalá-la.
- Forum — faça perguntas e compartilhe fluxos em GitHub Discussions.
- Bug Report — informe problemas no issue tracker.