Knowns CLI
Knowns · Produtividade · Aprendizado
O Knowns CLI é uma ferramenta de linha de comando local-first que dá aos assistentes de programação com IA uma camada de memória persistente para o seu projeto. Em vez de repetir o mesmo contexto em cada chat, você roda `knowns init` uma vez dentro de um repositório. A partir daí, tarefas, documentos, decisões e contexto do agente ficam conectados entre o terminal e uma WebUI local. Ele funciona junto de ferramentas como Claude Code, Codex e GitHub Actions. Nenhuma conta hospedada é necessária.
Sobre Knowns CLI
O que é o Knowns CLI
O Knowns CLI ataca um problema com que qualquer pessoa que usa um assistente de programação com IA esbarra rápido: o assistente esquece. Cada sessão nova começa do zero, então você explica sua arquitetura de novo, cola os mesmos arquivos de novo e torce para o modelo ligar os pontos. O Knowns tira esse contexto da sua janela de chat e o coloca no próprio repositório, onde tanto pessoas quanto agentes podem inspecioná-lo depois.
A ferramenta se organiza em torno de um conjunto pequeno de comandos que deixam um estado estruturado. knowns init cria a camada de memória de um repositório. knowns task create transforma um pedaço de trabalho em um objeto endereçável que carrega prioridade, relações e contexto de origem junto consigo. knowns retrieve devolve um pacote de contexto ranqueado com citações anexadas, em vez de um palpite sem base. E knowns doctor expõe referências quebradas e orientações desatualizadas antes de o trabalho começar.
Dois limites vale conhecer de antemão. O Knowns é ferramenta para desenvolvedores, não um app de consumo. Se você não se sente à vontade em um terminal e não usa um agente de programação, há pouco aqui para você. A busca semântica também precisa de um provedor de embeddings como o Ollama ou um endpoint compatível com OpenAI; sem um, a busca cai em resultados por palavra-chave. Isso é uma queda real na qualidade da recuperação. A ferramenta continua funcionando.
Como começar
- Instale a CLI com Homebrew, npm, um script de shell, PowerShell ou npx, e verifique com
knowns --version. - Entre no repositório que você quer que o Knowns gerencie e rode
knowns initpara criar a camada de memória local e os arquivos leves de orientação. - Crie sua primeira tarefa com
knowns task create "Setup project" -d "Initialize project with Knowns"e um primeiro documento comknowns doc create. - Rode
knowns searcheknowns validatepara confirmar que a recuperação encontra o seu contexto e que a estrutura do projeto está sólida. - Conecte sua plataforma de IA com
knowns setup claude --globalouknowns setup codex --globale depois abra a WebUI comknowns browser --open.
Informações do produto
Uma visão rápida dos preços, das plataformas compatíveis e do desempenho de Knowns CLI.
Ideal para
Os usuários, tarefas e cenários em que esta ferramenta se encaixa melhor.
Usuários
- Desenvolvedores individuais que usam assistentes de programação com IA
- Equipes pequenas de engenharia
Tarefas
- Recuperar o contexto do projeto
- Acompanhar o trabalho planejado
- Auditar a saúde da documentação
Cenários
- Começar uma sessão nova em um repositório de longa duração
- Alternar entre vários projetos
- Rodar fluxos de agente em CI
Principais recursos
Memória de projeto persistente
A ideia central é simples: os comandos deixam contexto estruturado em vez de apenas imprimir uma saída. Inicialize um repositório uma vez, e tarefas, documentos, decisões e contexto do agente ficam conectados depois. Essa é a diferença entre uma ferramenta que responde uma pergunta e outra que lembra a resposta para a próxima vez.
Recuperação de contexto com citações
knowns retrieve devolve um pacote de contexto ranqueado com citações anexadas. Cada citação inclui um tipo mais um caminho ou um ID. Você pode buscar primeiro para achar fontes candidatas e depois expandir relações com --expand-references só quando um fluxo precisar de mais profundidade. Os modos palavra-chave, semântico e híbrido estão disponíveis.
Gestão de tarefas como estado do projeto
As tarefas criadas pela CLI viram objetos endereçáveis, não apenas linhas de uma lista. Prioridade, relações e contexto de origem viajam com cada tarefa, então knowns task TASK-042 --plain devolve algo revisável. Essa estrutura é o que deixa um agente de programação retomar uma tarefa existente e entender de imediato as decisões, os documentos e o trabalho relacionado que a formaram, sem que você cole nada desse histórico na conversa.
Documentação que substitui o contexto repetido
Os documentos guardam conhecimento duradouro do projeto. Isso supera reexplicar a mesma arquitetura em cada chat de IA. knowns doc create os adiciona ao mesmo armazenamento de que a CLI e a WebUI leem, então há uma única versão da verdade.
WebUI local
knowns browser --open abre uma WebUI local que espelha o estado de projeto da CLI, incluindo tarefas, documentos, visualizações de grafo e configuração. Você tem uma visão geral visual sem sair da sua máquina nem entrar em um serviço hospedado.
Configuração de plataformas para agentes de programação
knowns setup <target> --global gera a configuração certa de integração MCP, as skills e os hooks de execução para Claude Code, Codex, OpenCode, Kiro, Cursor, Gemini CLI, GitHub Copilot e um destino genérico de agentes. O Claude usa comandos de skill /kn-. O Codex usa comandos $kn-.
Verificações de saúde com knowns doctor
Orientações desatualizadas e referências quebradas são o tipo de coisa que você descobre no pior momento, em geral no meio de uma tarefa quando um agente segue com confiança um documento que já não bate com o código. knowns doctor as expõe antes do trabalho começar, o que mantém a camada de memória confiável com o tempo.
Instalação flexível
Um único binário é distribuído para cada plataforma, sem biblioteca compartilhada embutida, então a CLI se comporta igual no macOS, no Linux e no Windows. Homebrew, npm, shell, PowerShell e npx são todos suportados. O npx deixa você experimentar sem uma instalação global.
Prós e contras
Prós
- Design local-first sem conta hospedada, então a memória do projeto fica na sua máquina.
- A recuperação com citações dá aos agentes fontes fundamentadas em vez de palpites confiantes.
- Boa cobertura de plataformas, de Claude Code e Codex a Cursor e GitHub Copilot.
- Funciona com o seu repositório atual, então não há etapa de migração.
Contras
- A busca semântica precisa de um provedor de embeddings separado, senão a qualidade cai para busca por palavra-chave.
- Sem conta hospedada, o contexto não sincroniza entre máquinas por padrão.
- Curva de aprendizado pequena se você é novo em ferramentas de CLI, já que o valor vem do uso consistente dos comandos.
Perguntas frequentes
Ele dá memória persistente de projeto aos assistentes de programação com IA. Você inicializa um repositório uma vez, e tarefas, documentos, decisões e contexto do agente ficam conectados. Os assistentes param de perder o fio entre sessões.
Conteúdo relacionado
Explore ferramentas, skills e artigos relacionados a Knowns CLI.
Alternativas a Knowns CLI
Base Code
Base44 (Wix) · Programação · ProdutividadeO Base Code é um ambiente de desenvolvimento em nuvem compartilhado da Base44. O time descreve mudanças em um repositório do GitHub pelo chat, confere tudo na prévia e envia o resultado como pull request.
Knocket
Knocket (Tencent RTC team) · Produtividade · Negócios · ChatbotO Knocket é uma ferramenta gratuita de chat ao vivo e página de contato: o visitante escreve pelo site, pelo app ou por um link, e você responde pelo Telegram ou por uma única caixa de entrada.
FloorGen
Vinit Kumar (FloorGen) · Produtividade · IA chinesaO FloorGen é um criador de plantas que roda no navegador e transforma uma frase ou um esboço em planta 2D editável e passeio em 3D. Exporta em PDF, DXF ou vídeo, e desenhar não exige conta.