A CLI

eidos é a metade mecânica do padrão como um programa. Publicado no npm como eidosmd.

npm install -g eidosmd
eidos --help

Node 20 ou mais recente. Sem conta, sem serviço: ele lê e escreve arquivos comuns no seu repositório, e instala em um ou dois segundos.

O que ele faz

Comando	Faz
`eidos install`	Cria uma raiz a partir de uma semente ou de um Framework (a estrutura) publicado, ou traz peças para uma que já existe
`eidos new`	Monta um Blueprint (o plano) que nasce conforme
`eidos check`	Valida a raiz contra o próprio Framework: erros e avisos, nunca uma recusa
`eidos index`	Reconstrói o índice dentro do `Framework.yaml`
`eidos framework`, `list`, `show`	Lê o Framework e os Blueprints, `--json` para scripts
`eidos property`	Obtém, define ou remove uma propriedade de um Blueprint a partir do shell
`eidos configure:<noun>`	Muda o Framework: uma propriedade, coleção, pasta, grupo, variant (variante), termo, documento ou papel
`eidos draft`	Começa um Blueprint antes de ele ter uma coleção, e o publica quando tiver
`eidos browser`	Abre a raiz em uma página web local: uma bancada com um editor de markdown e as visões de cada plugin
`eidos plugin`, `setup`	Quais plugins estão ligados na raiz, os usuários, como quem esta máquina age
`eidos canvas`, `comments`, `backlog`, `assets`, `linter`	Os comandos próprios dos plugins, cada um montado enquanto o seu plugin está ligado
`eidos version`	Registra um instantâneo nomeado da raiz, quando pedido
`eidos migrate`	Leva uma raiz ao padrão que a CLI carrega
`eidos roles`, `whoami`	Os papéis que o Framework traz, e quem está na cadeira
`eidos instructions`, `agents`	O fluxo que um agente segue, e um ponteiro para ele no `AGENTS.md`

ComandosCada comando, suas opções e os códigos de saída.

O navegadorUma bancada sobre a raiz: tabelas, um leitor e editor, o canvas, comentários, um backlog e o seu agente.

PluginsA premissa a que todo plugin é submetido, o interruptor e uma página para cada um: Canvas, Git, Comments, Backlog, Assets, Linter, Terminal e Plato.

Como ele implementa o padrão

A raiz é encontrada pela sua marca. Todo comando encontra a raiz pelo .eidos/ dentro dela, subindo a árvore a partir de onde você roda e depois dois níveis para baixo. --root <path> nomeia uma explicitamente.
O Framework é lido da raiz, nunca de uma cópia. Nada sobre o nome de uma coleção, seção ou propriedade está fixo no código. Framework →
O frontmatter é gerado a partir da tabela de propriedades. new preenche o que pode e deixa o resto em branco em vez de adivinhar. Propriedades →
A validação mostra, nunca bloqueia. check relata contra a tabela e os templates (os modelos) do seu próprio Framework. A saída é uma revisão sobre a qual uma pessoa age. O que o check relata →
O índice é regenerado por inteiro. index reescreve uma chave do Framework.yaml e nada mais.
A orientação para agentes é um comando. eidos instructions imprime o fluxo, reformulado em torno dos comandos. Agentes →

O que ele nunca faz

Nunca escreve uma frase da prosa de um Blueprint, decide escopo, resolve uma pergunta em aberto ou preenche uma propriedade em branco com um valor plausível. Isso é do dono.

Licença e versões

A CLI e o app de desktop são grátis para qualquer uso, pessoal ou comercial, como são: licenciados sob a PolyForm Strict 1.0.0 com uma permissão adicional para uso comercial, não podem ser modificados, usados como base de obras novas nem redistribuídos. O padrão e as sementes são da Buildable, Apache-2.0.

A CLI é versionada separadamente do padrão que carrega. eidos --version nomeia os dois. Versionamento →