A skill termfy-brand ajusta a identidade do binário depois do setup:
nome do executável e os campos que o apresentam no terminal e nos agentes.
Ela também altera os créditos e a aparência da TUI, usando os arquivos
responsáveis por cada campo. A tabela deste guia mostra essas origens. A skill
mantém essa fonte em ordem para que --version, about, a aba About, o
OpenCLI e o servidor MCP mostrem os mesmos valores. No fim, você tem os
campos novos aplicados, as superfícies conferidas e o bun run validate
verde.
Quando usar
Use a termfy-brand nestas situações:
- A loja mudou de nome e o
mycliprecisa de outro título ou descrição. - Você quer a cor da marca no destaque da TUI.
- Você quer acrescentar um crédito, um site ou uma licença à aba About.
- Você precisa renomear o executável depois que o projeto já existe.
Prefira outra skill nestes casos:
- O repositório acabou de sair do template e ainda responde
termfy: use termfy-init, que faz o rename inicial. - Você quer mudar o propósito, os públicos ou os limites do binário: use termfy-clispec. Identidade é nome e aparência, não escopo.
- Você quer uma screen nova ou um layout diferente: use a
termfy-tui.
Como pedir
Para trocar a cor e o autor:
Use a skill termfy-brand para usar a cor #e4572e como destaque da TUI do mycli e trocar o autor para Loja Exemplo Ltda.
Para acrescentar um crédito:
Use a skill termfy-brand para acrescentar aos créditos do mycli a API da loja, com o papel “orders and customers API” e o site da loja.
Para renomear o executável:
Use a skill termfy-brand para renomear o mycli para lojacli, mantendo o título My CLI.
O que a skill faz
- Lê o estado atual com
git status --shortebun run dev -- about --json. - Mostra cada campo que muda, com o valor atual e o proposto lado a lado. Depois, espera a sua confirmação.
- Aplica os campos no
package.json(blocotermfye campos raiz). Para créditos, editasrc/app/manifest.ts. Para cores e glifos, editasrc/tui/theme.ts. - Se o
binmudou, rodabun run init -- --name <bin>e ajusta o título e a linha dobinnoCLISPEC.md. - Roda
bun run opencliebun run validate. - Confere as superfícies:
bun run dev -- --version,bun run dev -- about,bun run dev -- --help | head,bun run dev -- mcp --liste a aba About no testetests/tui.test.ts(oubun run devem um terminal). - Registra a mudança no
CHANGELOG.mddo projeto.
Exemplo
Cada campo vive em um lugar e alimenta várias superfícies. A skill segue esta tabela de origens:
| Campo | Onde fica | Onde aparece |
|---|---|---|
bin |
termfy.bin no package.json |
~/.<bin>/, <BIN>_HOME, <bin>://, --version, --help |
title |
termfy.title |
cabeçalho da TUI, aba About, about, OpenCLI |
description |
description |
--help, cabeçalho da TUI, OpenCLI, MCP |
author, site |
bloco termfy |
about, aba About, OpenCLI |
license |
license |
about, aba About, OpenCLI |
| créditos | credits em src/app/manifest.ts |
about, aba About, tool MCP about |
| paleta | DEFAULT_TERMINAL_SLOTS, themes.night e themes.day em src/tui/theme.ts |
toda a TUI |
Para a cor de marca do primeiro exemplo, a skill altera só os papéis de
destaque. No tema terminal, ela escolhe o slot ANSI mais próximo em
DEFAULT_TERMINAL_SLOTS. Nas paletas night e day, ela grava o hex.
export const themes: Record<"night" | "day", Theme> = { night: { name: "night", // ... borderActive: "#e4572e", accent: "#e4572e", accentSecondary: "#f08a6c", keyBackground: "#e4572e", // ... }, day: { name: "day", // ... borderActive: "#c43d16", accent: "#c43d16", accentSecondary: "#e4572e", keyBackground: "#c43d16", // ... },};O relato chega como uma tabela de antes e depois:
Campo Antes Depoisauthor Loja Exemplo Loja Exemplo Ltdaaccent (terminal) ANSI 4 ANSI 1accent (night) #7aa2f7 #e4572eaccent (day) #2e7de9 #c43d16
Arquivos: package.json, src/tui/theme.ts, docs/opencli.json, CHANGELOG.mdConferido: --version, about, --help, aba About, mcp --listRegras que a skill segue
- Uma fonte de identidade. Os valores ficam no bloco
termfydopackage.jsonmaisname,version,descriptionelicense. Osrc/app/manifest.tslê dali e as superfícies leem do manifest. Um valor copiado em outro arquivo fica velho na próxima mudança. - Créditos ficam em
credits. Cada crédito tem nome, papel e URL. A skill não remove Bun, OpenTUI e MCP SDK enquanto o binário os usa, porque o crédito descreve o que roda de fato. - Mudar
biné um rename. A skill usabun run init -- --name <bin>, que reescrevepackage.json,.env.example,README.md,AGENTS.md,CHANGELOG.mde workflows. A pasta~/.<bin>/, o prefixo<BIN>_e o esquema<bin>://mudam junto. A skill avisa que as configurações e as credenciais antigas ficam na pasta antiga. - O título fica no rename. Sem
--title, o script mantém o título atual (“My CLI” continua “My CLI”). Para trocar os dois, passe--namee--titlena mesma chamada. descriptionem inglês, abaixo de 80 caracteres. Ela aparece no--help, no cabeçalho da TUI e no OpenCLI. Acima disso, o cabeçalho corta o texto.- Cores por papel, nas três paletas. No tema
terminal, a marca escolhe o slot ANSI emDEFAULT_TERMINAL_SLOTS, por exemploaccent: ANSI.cyan, sem hex. Cor hex da marca entra emnighteday. A cor entra comoaccent(eaccentSecondaryquando houver uma segunda cor). Ela não vira campo novo usado por uma screen só. Assim, trocar de tema mantém a marca. - Contraste mínimo de 4.5:1. A skill confere
textsobresurfaceekeyTextsobrekeyBackground. Abaixo disso, a leitura fica difícil em vários terminais. - About e
aboutmostram o mesmo. Os dois leemaboutData()emsrc/cli/commands/about.ts. Um campo novo entra nessa função e aparece nas duas superfícies. - Sem logo em ASCII. O cabeçalho da TUI usa o glifo
▌mais o título. Para um glifo próprio, a skill trocaglyphs.blockemsrc/tui/theme.ts, que ocupa uma célula em vez de várias linhas. - OpenCLI regenerado. Depois de qualquer mudança, a skill roda
bun run opencli, porque o blocoinfododocs/opencli.jsonmuda junto e oopencli:checkfalharia. CLISPEC.mdalinhado à mão. O título, obine adescriptiondoCLISPEC.mdprecisam bater com opackage.json. A skill não altera a Surface nem o índice## Specs, porque identidade não muda o que o binário faz.
O que ela entrega
A skill relata:
- os campos alterados, com o valor anterior e o novo,
- os arquivos alterados,
- as superfícies conferidas,
- o aviso do rename da pasta
~/.<bin>/quando obinmudou.
Arquivos que podem mudar: package.json, src/app/manifest.ts,
src/tui/theme.ts, src/tui/screens/about.ts (painel “Standards”),
src/cli/commands/about.ts, docs/opencli.json, CLISPEC.md e
CHANGELOG.md. No rename, também .env.example, README.md, AGENTS.md
e os workflows.
Próxima skill
Se o projeto ainda não tem CLISPEC.md, siga para a
termfy-clispec. Se ele já tem, volte ao trabalho da
spec aberta com a termfy-spec ou deixe a
termfy escolher o próximo passo.