fcontext
lijma · Programação · Produtividade
O fcontext é um sistema de gestão de contexto por linha de comando que mantém os agentes de programação com IA alinhados entre sessões, ferramentas e colegas de equipe. Ele guarda o conhecimento do projeto em uma pasta local `.fcontext/`, converte documentos como PDF e DOCX em Markdown legível e ensina agentes como GitHub Copilot, Claude Code e Cursor a ler essa pasta antes de começar o trabalho. A proposta é simples. Menos explicações repetidas, resultados mais consistentes e menos contexto desperdiçado a cada chat novo. Como ferramenta de gestão de contexto para agentes de IA, ele conquista seu lugar rápido.
Sobre fcontext
O que é o fcontext
O fcontext é uma ferramenta de Python de código aberto criada para resolver uma dor de cabeça específica. Os agentes de programação com IA esquecem tudo no momento em que uma sessão termina, e trocar de um agente para outro apaga o quadro outra vez. O fcontext resolve isso mantendo um único repositório compartilhado de contexto do projeto que qualquer agente compatível consegue ler.
Tudo fica em um diretório .fcontext/ dentro do seu projeto, então seus dados permanecem locais. Não há conta na nuvem, nem chave de API, nem telemetria. Você pode rodá-lo totalmente offline, o que importa se você trabalha com bases de código privadas ou documentos de clientes que não pode enviar para nenhum lugar.
A principal limitação também é sua força. O fcontext é uma CLI, então você precisa estar à vontade em um terminal, e ele só ajuda os agentes que você habilita de forma explícita com um comando. Ele não se conecta por mágica a uma ferramenta para a qual não tem adaptador, e não gerencia o contexto de aplicativos fora dos doze agentes que suporta atualmente.
Primeiros passos
- Instale o pacote com
pip install fcontext(requer Python 3.9 ou superior). - Rode
fcontext initna pasta do seu projeto para criar o diretório.fcontext/. - Ative seu agente, por exemplo
fcontext enable copilotoufcontext enable claude, para que ele receba instruções em seu formato nativo. - Indexe seus documentos com
fcontext index docs/para converter PDF, DOCX e planilhas em Markdown que o agente consiga ler. - Confira tudo com
fcontext statuse comece sua próxima sessão. O agente lê o resumo do projeto e os tópicos automaticamente.
Informações do produto
Uma visão rápida dos preços, das plataformas compatíveis e do desempenho de fcontext.
Ideal para
Os usuários, tarefas e cenários em que esta ferramenta se encaixa melhor.
Usuários
- Desenvolvedores autônomos que perdem o contexto entre sessões
- Equipes que passam trabalho entre membros
- Desenvolvedores que usam vários agentes
- Equipes focadas em privacidade
Tarefas
- Retomar uma linha de depuração no dia seguinte
- Integrar um colaborador novo
- Trabalhar com documentos binários
- Acompanhar requisitos
Cenários
- Um projeto longo espalhado por muitas sessões curtas de IA, onde consistência importa mais que velocidade.
- Uma equipe em que os requisitos vivem em documentos e as decisões de arquitetura em conversas passadas.
- Ambientes regulados ou offline em que ferramentas de contexto na nuvem não são uma opção.
Principais recursos
Memória entre sessões e entre agentes
O fcontext mantém um resumo vivo do projeto em _README.md e guarda o conhecimento de cada sessão em _topics/. Todos os agentes compatíveis leem ambos antes de começar, então o contexto sobrevive entre conversas e viaja entre ferramentas. Troque de Copilot para Claude e depois para Cursor e o panorama do projeto permanece intacto.
Suporte a vários agentes em formatos nativos
Um comando ativa um agente, e o fcontext escreve as instruções no formato que aquele agente espera. O Copilot recebe .github/instructions/, o Claude recebe .claude/rules/, o Codex recebe AGENTS.md, o Zed recebe .agents/skills/, e assim por diante. Doze agentes são cobertos, todos compartilhando os mesmos dados por baixo.
Indexação de documentos para Markdown
Os agentes não conseguem ler um PDF ou uma apresentação do Keynote sozinhos. O fcontext converte arquivos PDF, DOCX, XLSX, PPTX, Keynote e EPUB em Markdown guardado em _cache/, para que um agente possa citar sua especificação diretamente em vez de adivinhar.
Pacotes de experiência para equipes
O conhecimento capturado em um projeto pode migrar para outro. Exporte um pacote como zip, URL do git ou link de download, e depois importe em outro lugar com fcontext experience import. Novos colegas baixam o pacote e o agente deles passa a compartilhar na hora as convenções da equipe e as armadilhas conhecidas.
Gestão de requisitos com histórico
Os comandos fcontext req cuidam de itens de roadmap, épicos, histórias, tarefas e bugs. Você tem uma visão em árvore, um quadro Kanban e tipos de vínculo como substitui, evolui e bloqueia. Os agentes leem requisitos estruturados em vez de analisar um CSV à mão, o que reduz a construção da coisa errada.
Local, offline, sem nuvem
Todos os dados ficam em .fcontext/ e podem ser rastreados no git junto com seu código. Não há conta para criar, nem telemetria, nem dependência de rede, então funciona em máquinas isoladas e mantém o material do cliente no seu próprio hardware.
Prós e contras
Prós
- Gratuito e de código aberto sob Apache 2.0, sem um nível pago retendo recursos principais.
- Os dados ficam locais em `.fcontext/`, então privacidade e trabalho offline não são problema.
- Cobre doze agentes de programação populares e escreve a configuração no formato nativo de cada um.
- A indexação de documentos transforma PDFs e arquivos de escritório em texto que os agentes conseguem usar de verdade.
- Os pacotes de experiência tornam o conhecimento da equipe portátil entre projetos e pessoas.
Contras
- É uma ferramenta de linha de comando, então quem evita o terminal vai achar a configuração difícil.
- O valor depende de usar um agente compatível; ferramentas não suportadas não ganham nada.
- Você precisa lembrar de rodar `fcontext init` e `enable` em cada projeto, algo fácil de esquecer em scripts rápidos.
- O projeto é novo, então alguns fluxos como o acompanhamento de requisitos ainda podem mudar entre versões.
Perguntas frequentes
Sim. O fcontext é publicado sob a licença Apache 2.0 e instala pelo PyPI sem custo. Não há plano pago, nem assinatura, nem recurso bloqueado atrás de uma atualização.
Conteúdo relacionado
Explore ferramentas, skills e artigos relacionados a fcontext.
Alternativas a fcontext
Forefront
Forefront · ProgramaçãoO Forefront é uma plataforma web para construir com IA de código aberto. Você ajusta os principais modelos de linguagem de código aberto com seus próprios dados, avalia o desempenho deles e os roda por uma API ou os exporta para hospedar por conta própria. Desenvolvedores que querem a conveniência de uma plataforma fechada, mas fazem questão de ser donos dos modelos e dos dados, são o público-alvo aqui.
Startkit
StartKit.AI · ProgramaçãoStartkit é um boilerplate para criar produtos de SaaS com IA e wrappers de IA. Pense nele como um boilerplate para startups de IA com as partes chatas já conectadas: autenticação, pagamentos com Stripe e Lemon Squeezy, limites de uso, e-mail transacional e um kit inicial de API de IA que conversa com OpenAI, Anthropic, Groq ou Llama. Você clona o repositório, define seu preço e começa pela parte do produto que as pessoas realmente pagam. Ele é feito em Next.js sobre React e Tailwind, então boa parte do código boilerplate já parece familiar.
Testim
Tricentis · ProgramaçãoO Testim é uma plataforma de automação de testes com IA para criar e executar testes de ponta a ponta em aplicações web, mobile e Salesforce. Ele se apoia no aprendizado de máquina para manter os testes estáveis quando uma interface muda, então as equipes gastam menos tempo consertando seletores quebrados. Nada mal para uma ferramenta de testes automatizados que você pode começar a usar hoje. Você cria testes gravando ações no navegador e depois adiciona JavaScript quando precisa de mais controle. É uma escolha sólida para equipes de QA ocupadas.