Digite para filtrar as páginas da documentação.

    Termfy

    Visão geral

    Entenda a relação entre o framework Termfy e o starter kit Bun. Conheça os três modos do executável e as escolhas técnicas usadas nos projetos derivados.

    Você pode usar uma ferramenta de terminal digitando comandos, chamando-a por um script ou conectando um agente de IA. O script precisa de saída estruturada e o agente precisa descobrir as funções disponíveis. O Termfy reúne essas formas de uso no mesmo projeto para compartilhar as funções entre os três modos.

    O Termfy resolve isso com um único executável que atende os três:

    Público Modo Como entra
    pessoa TUI mycli sem argumentos, em terminal interativo
    pessoa, script, agente CLI mycli <comando> [opções], texto ou --json
    agente de IA MCP mycli mcp, servidor Model Context Protocol via stdio

    Os três modos compartilham a configuração e a identidade do binário. Também usam o mesmo cofre de credenciais e os mesmos códigos de saída. Um comando novo aparece no --help, no --json, na descrição OpenCLI e na documentação embutida sem duplicar texto.

    As peças

    Starter kit. O repositório promovaweb/termfy-starter-kit é um template do GitHub com o esqueleto pronto: src/ com as camadas app, cli, config, mcp, tui e skill, docs/ embutida no binário, stubs em template/, testes, workflows de CI e release. Ele já vem com as skills do framework instaladas em .agents/skills/.

    Framework. O repositório promovaweb/termfy guarda as 18 skills que ensinam um agente a criar e evoluir um projeto derivado, as referências que elas usam (documentação do OpenTUI, da OpenCLI, do MCP) e este guia, publicado em PDF e EPUB.

    Projeto derivado. É o repositório que você cria a partir do starter kit, renomeando o executável e acrescentando comandos, telas e tools. As atualizações das skills chegam pela manutenção conduzida por termfy-init.

    Escolhas que o framework já fez

    • Bun como runtime, bundler e compilador. bun build --compile gera um executável único por plataforma, com a biblioteca nativa do OpenTUI e a documentação embutidas.
    • OpenTUI (@opentui/core) para a interface de terminal, com layout flexbox, renderização incremental e renderer de teste para capturar frames.
    • MCP TypeScript SDK 1.x para o servidor stdio, com schemas Zod.
    • OpenCLI 0.1 como formato de descrição da CLI, gerado do registro de comandos.
    • AES-256-GCM para o cofre de credenciais, com chave mestra em arquivo 0600 ou em variável de ambiente.
    • Inglês no código e na interface do binário: arquivos, identificadores, comentários, commands, options, keys e campos do --json. Documentação, guia e skills em português do Brasil, com os termos técnicos em inglês.

    Público do guia

    O guia se destina aos desenvolvedores da Promovaweb e aos alunos que constroem ferramentas internas, integrações com APIs e utilitários para agentes. Você precisa ter familiaridade com terminal e TypeScript para acompanhar os exemplos. Para estudar Bun ou MCP do início, consulte a documentação oficial indicada pelas skills.

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano