Usar o app

A página abre no Eidos MD, o app de desktop: baixe-o, abra uma pasta e o projeto está lá. A CLI não serve a página. O app de desktop →

A bancada

A moldura é a do VS Code. Um centro de comandos no topo abre a paleta: vazia, lista o que você abriu recentemente e, conforme você digita, encontra Blueprints (os planos), documentos, rascunhos, tarefas, canvases e arquivos de assets por título, id e caminho (T-A7GJ encontra a tarefa, B-5KFM o Blueprint), e o que você escolhe abre na sua página própria, não no leitor sobre uma tabela; > lista todos os comandos que o anfitrião e cada plugin registraram, com a sua tecla. ⌘P abre a paleta e ⇧⌘P a abre nos comandos; as duas são atalhos de teclado, alterados em Hot keys como qualquer outro. Setas de voltar e avançar ficam ao lado. Um comando Ir para mostra a atividade que contém o seu destino (a visão Core do projeto para uma coleção ou um documento de nível superior, a atividade de um plugin para as suas páginas) e abre a barra lateral se ela estiver oculta. Cada atividade tem um comando Focar (Focar Projeto, Focar Backlog) que mostra a sua visão onde quer que você a tenha posto e leva o cursor até ela, e cada atividade com configurações um comando Abrir as configurações de … que vai aonde vai o item de configurações do seu menu de contexto; qualquer um deles aceita uma tecla em Hot keys.

/ abre na Home, o Início que você organiza. O cabeçalho é o nome do projeto: o produto que ele define (eidos setup --product, ou o lápis ao lado dele), senão o repositório em que ele está; a aba do projeto no app leva o mesmo nome. Abaixo do cabeçalho vem a primeira coleção ou o primeiro Blueprint a criar, enquanto o projeto precisa de um, depois os seus widgets na sua ordem, e Novidades por último. Adicionar widget, à direita do cabeçalho, lista os widgets que não estão no seu Início e adiciona no fim o que você escolher: Verificação (as constatações, os erros primeiro), O projeto (os Blueprints por coleção, com os documentos e rascunhos contados) e, do Backlog, Atribuído a você e No quadro, com os que um plugin adicionar. O menu de cada widget (o ⋯ ao passar o mouse, ou um clique direito) tem Mover para cima, Mover para baixo e Remover do Início, e ⌥↑ e ⌥↓ movem o widget que está com o foco. O seu Início é seu, guardado no local.yaml do projeto; enquanto você não organiza o seu, vê o Início do projeto, vazio a não ser que quem edita o framework o defina. Quem edita o framework o define com Usar como Início do projeto em Adicionar widget, o Início com que começa quem não tem um próprio, e Voltar ao Início do projeto troca o seu por ele. Um widget cujo plugin está desligado não é desenhado e mantém o lugar, então volta onde estava.

Uma barra de atividades na borda esquerda tem primeiro uma casa para a Home, depois um ícone por visão da barra lateral principal: primeiro a visão Core do projeto (os documentos de nível superior, as coleções como uma só árvore de arquivos e o grupo Records; sob uma linha, as visões salvas, os rascunhos e o grupo de cada outro plugin), depois a atividade de cada plugin na ordem que você definir (Canvas, Comments, Backlog, Source control, Assets, Settings); o menu da conta (Entrar, ou a sua conta, e a pessoa como quem você age) e uma engrenagem ficam no pé. Uma barra lateral auxiliar na borda direita e um painel sob a área principal são fileiras de abas que um plugin preenche (o histórico de um Blueprint, suas tarefas e assets anexados, o Chat, o Terminal), escondidas até serem mostradas. Cada setor mostra, esconde e redimensiona como no VS Code (⌘B, ⌥⌘B, ⌘J, arrastando a borda), e tudo é lembrado por pessoa em local.yaml. Onde um plugin coloca uma visão é só onde ela começa: arraste o ícone ou a aba dela para outro setor (o Chat para o painel, o Terminal para a barra lateral principal), ou clique com o botão direito para Mover para, e ela fica lá em todos os projetos até você devolvê-la ou executar Redefinir a localização das visões. Clique com o botão direito na barra de título (Voltar e Avançar, a busca, os botões dos setores) para ver a barra de atividades, a barra lateral principal, o painel e a barra lateral auxiliar, cada um marcado enquanto aparece, então uma barra de atividades escondida, com o menu da conta e a engrenagem no pé, volta com um clique. As linhas de uma lista da barra lateral seguem a sua própria ordem: arraste uma para onde você quiser, com uma linha marcando onde ela cai, clique nela com o botão direito (ou use o seu ⋯) para Move up e Move down, ou pressione ⌥↑ e ⌥↓ enquanto ela tem o foco. Isso vale para os documentos de nível superior, as coleções e os rascunhos da visão Core do projeto; as páginas das atividades Backlog e Comments; as visões salvas de uma página; os canvas; as pastas da atividade Assets; e os ícones da barra de atividades. A ordem das páginas das atividades é sua em todo projeto, em preferences.yaml; a das linhas próprias de um projeto (os seus documentos, coleções e rascunhos, as suas visões, as compartilhadas incluídas, os seus canvas, as suas pastas) fica com esse projeto, no seu local.yaml, e nunca é escrita nos arquivos que o projeto compartilha. Os status e os tipos mantêm a ordem que as configurações do projeto lhes dão, porque essa ordem é compartilhada.

A visão Core do projeto mostra o projeto como uma só árvore de arquivos. Cada coleção é uma pasta, os seus grupos são pastas dentro dela e cada Blueprint é uma linha só com o seu nome, com um ponto quando a verificação tem algo a dizer sobre ele; uma pasta abre e fecha com um clique e lembra como você a deixou. Passe o mouse sobre uma coleção ou um grupo para ver um + que cria um Blueprint ali e um ícone de tabela que abre a sua tabela (a de um grupo, filtrada por ele); a pasta da tabela aberta fica acesa. Um clique com o botão do meio abre um Blueprint numa aba atrás, e um clique com o botão direito oferece o menu que a sua linha tem na tabela. A visão se abre no Core (o núcleo) do projeto, sob um único rótulo: os documentos de nível superior como linhas, com o Vocabulary por último, depois as coleções e depois o grupo Records. Depois vem o resto, cada grupo separado pelo seu título: as visões salvas de todas as coleções num grupo Views, os rascunhos como duas pastas, Local (aberta) e Shared (recolhida até você abrir), cada uma com o seu +, e o grupo de cada outro plugin. Quem edita o framework pode listar o Vocabulary nas configurações do Framework, para todo o projeto, com Mover para as configurações no clique direito, e trazê-lo de volta com Mover para o Core no clique direito de lá. O Core → Abra um Blueprint de qualquer lugar (a busca, um link, uma aba) e a árvore desdobra as pastas que o contêm, o acende e rola até ele; Reveal the open file em Preferences → Workbench desliga isso.

Procurar, a primeira das atividades até você arrastá-la para outro lugar, é a busca do centro de comandos aberta na barra lateral principal (⇧⌘F): primeiro o que corresponde pelo título, depois cada menção no texto com a correspondência marcada. Abas: as páginas abrem como abas sobre a área principal, cada uma com uma marca que diz o que ela contém (um arquivo, uma tabela, uma página própria de um plugin). Um filtro ou um leitor sobre a página visível fica na sua aba. Qualquer outra página que você abre vai para a aba de pré-visualização, com o título em itálico, que a próxima página que você abrir ocupa, como os editores de pré-visualização do VS Code; edite a página, dê um clique duplo na aba ou no link para ela, escolha Keep Open no seu menu ou fixe-a, e ela fica. Desligue Enable preview em Preferences → Workbench e cada página abre numa aba própria. ⌘ e clique num link ou + abre uma aba própria, fixe uma aba para manter a sua página e feche uma com o seu ×, um clique com o botão do meio ou o seu menu; ao fechar a última, a área principal fica vazia até você abrir uma página. As abas abertas são lembradas para cada projeto. Um clique com o botão do meio num link, numa entrada da barra lateral, num resultado da busca, numa linha de uma tabela ou num cartão do quadro abre a página numa aba nova, com o nome do que você clicou até a página nomeá-la, e deixa a página em que você está como está. Um leitor mostrado num modal (um Blueprint, um rascunho, uma tarefa, um pacote do Registro, uma thread de comentários) tem dois ícones antes do seu ×, para abrir numa aba nova ou nesta aba. O modo foco, em Preferences → Workbench, mostra uma página de cada vez. Procurar no arquivo (⌘F) encontra texto na página ou no arquivo aberto, com cada correspondência marcada, e Enter e ⇧Enter para percorrê-las.

As coleções como tabelas

Cada coleção é uma tabela: uma linha por Blueprint, as propriedades que se aplicam a ele como colunas, ordenável pelo cabeçalho, com uma caixa de busca, um seletor de colunas e um filtro por propriedade marcada como tal; uma propriedade que também tem Only show actively used in filters ligado oferece só os valores que um Blueprint da coleção tem. Um filtro com um valor mostra isso, em toda página que tem filtros: o botão nomeia o filtro e o valor na cor de destaque, e o × dele volta para todos. Um dropdown de dez opções ou mais, seja de um filtro ou de um campo, abre com uma busca: digite parte de um valor para estreitar a lista e escolha-o com as setas e Enter. Uma coleção agrupada mostra o seu grupo como a primeira coluna, com as linhas planas, já que a árvore da visão Core do projeto é onde os grupos se aninham. Um ponto no fim de uma linha marca um Blueprint sobre o qual a verificação tem algo a dizer. N começa um Blueprint novo; toda tabela da página ordena do mesmo jeito, com os filtros à esquerda. Na tabela do Backlog, o cabeçalho do título tem um segundo alvo, ID, que ordena por id: em ordem natural no esquema de ids sequencial (T-2 antes de T-10, T-F36.2 antes de T-F36.10), e pelo dia em que cada um foi criado num esquema aleatório, cujos ids não têm ordem. Toda tabela tem a mesma caixa de busca, a primeira entre os seus filtros (a de uma coleção, a tabela, o quadro, os rascunhos e os marcos do Backlog, os rascunhos de Blueprints, os assets, Teclas de atalho, Vocabulary, Versions): ela deixa as linhas que têm cada palavra que você digita, sem importar maiúsculas nem ordem, no id, no título ou num valor que a linha mostra, e o × dela a esvazia. No quadro, na tabela e nos rascunhos do Backlog, na tabela de uma coleção e nos assets, os filtros (a busca entre eles como q) ficam no endereço da página, então uma tabela filtrada pode ir para os favoritos, ser compartilhada, recarregada e alcançada de novo com voltar e avançar; mudar um não acrescenta um passo ao histórico. As outras tabelas guardam os seus enquanto a página está aberta. Um botão de atualizar ao lado da busca lê de novo as linhas da tabela, para uma mudança que não chegou a ela sozinha; uma mudança feita num modal sobre a tabela (o status de uma tarefa definido no seu leitor, por exemplo) chega sem ele.

Ícones e cores

Clique com o botão direito em uma coleção, um grupo ou qualquer pasta da visão Project Core, ou em um blueprint ali ou na sua tabela, e escolha Alterar ícone…. O seletor busca os ícones do Lucide pelo nome e pelo que mostram, e um conjunto de emoji pelo nome; qualquer outro emoji digitado ou colado na busca também pode ser usado. Embaixo, escolha uma cor. Cada escolha aparece na hora, então um ícone e uma cor são definidos juntos, e Remover (ou Remover ícone no clique direito) tira os dois. O ícone de uma pasta toma o lugar da sua marca de pasta, e a cor tinge a marca, o nome e a linha ao lado do que ela contém; o ícone de um blueprint fica antes do nome. A aba de um blueprint e a tabela de uma coleção usam o mesmo ícone. Os ícones são do projeto, guardados em .eidos/plugins/eidosmd/settings.yaml e enviados com ele, para que todos vejam a mesma árvore. eidos icons →

Visões salvas

Quando o quadro, a tabela ou os rascunhos do Backlog, ou a tabela de uma coleção, estão filtrados, Save as view no ⋮ ao lado da sua busca salva os filtros e a ordem da página com um nome: Local, nesta máquina em local.yaml e nunca enviada ao git, ou Shared, em .eidos/plugins/eidosmd/views.yaml e enviada com o projeto, para que o time todo a veja. A visão aparece na hora na barra lateral principal num grupo das visões da sua página (Board views, Task views e Draft views no Backlog; as de todas as coleções num grupo Views sob o Core), uma local com o ícone de notebook, e abre essa página como foi salva; o seu endereço é o da página com view=<id> (/p/backlog?view=V-7K2M&assignee=agent), e a ordem fica ao lado dos filtros como sort=<coluna>, com um - antes da coluna para o sentido contrário. Se você muda os filtros ou a ordem de uma visão que abriu, o ⋮ oferece Update view para ela ou Save as new view; clique com o botão direito numa visão, ou no seu ⋯, para renomeá-la, torná-la local ou compartilhá-la (Make local, Make shared; ela mantém o seu id, então uma página aberta nela continua nela) ou apagá-la. My work, By status e By type do Backlog são as visões com que todo projeto começa. eidos views →

Clique em uma linha para o leitor sobre a tabela: as propriedades à esquerda, que ficam paradas enquanto o corpo à direita rola com o seu trilho de conteúdo, achados e comentários embaixo, separados por uma linha. Esc volta à tabela; Abrir nesta aba abre o Blueprint como página própria. Abrir o leitor é um passo no histórico da página, então Voltar o fecha sobre a página de baixo, e Voltar a partir de uma página para a qual você saiu dele volta a ele, ainda aberto. Um documento de nível superior, um rascunho, uma tarefa e um asset abrem com a mesma forma. Clique com o botão direito em uma linha, aqui ou em qualquer tabela que liste coisas (os rascunhos, as tarefas e os marcos do Backlog, os assets), para ver as suas ações: primeiro as formas de entrar, o seu id ou caminho para copiar, as saídas para o arquivo, e por último a que o remove, que pergunta uma vez.

Reading, Editor, Source

A página de um leitor abre sobre uma barra que fica parada enquanto você rola: o caminho de volta e o id do Blueprint (specs / B-5KFM; a tarefa-mãe de uma tarefa e o seu próprio id, cada um com o ícone do seu tipo, Backlog / T-PARENT / T-TASK, só a tarefa-mãe e nunca a cadeia acima dela), sem nada para salvar ou reverter nela (Delete, Find in file, Mover spec para… (com o nome que a coleção dá a um), que leva o arquivo para outro grupo da sua coleção com todos os links seguindo, e Move to collection…, que o leva para outra coleção e um grupo dela depois que você lê o que a mudança altera, o novo caminho, os links que o seguem e cada propriedade definida ou removida, ficam no ⋮; um Blueprint arrastado para a pasta de outra coleção ou de outro grupo na barra lateral pergunta o mesmo); o título abaixo dela com o caminho embaixo, o id e o caminho cada um copiado de um link que aparece ao passar o mouse. Clique no título ou no resumo para mudá-lo ali mesmo (Enter ou um clique fora o mantém, Esc o descarta); um resumo vazio oferece Generate with AI, que pede ao AI Agent a frase que o índice lê.

O leitor tem os três modos do Obsidian, escolhidos no ⋮ ao lado do título (o que está em uso, marcado) e levados de página em página durante a sessão. Um Blueprint e uma tarefa abrem em Editor, então dá para digitar desde o primeiro clique; a preferência Default view (view_mode no preferences.yaml) escolhe outro, e quem a deixou em Reading ou Source o mantém. Reading mostra a página renderizada. Editor é um editor de markdown com a página renderizada enquanto você escreve: o bloco sob o cursor é desenhado como a página é lida, com a sintaxe de uma marca visível só onde o cursor a toca, marcado pela cor de destaque na borda, e todos os outros são desenhados; o arquivo continua exatamente como você digitou; um + em um bloco vazio, ou / no começo dele, abre um menu de blocos (títulos, listas, uma lista de tarefas, uma citação, código, uma tabela, uma régua, e o que os plugins oferecem: uma imagem ou um arquivo do Assets, uma tarefa do Backlog); um bloco escrito mostra no lugar o ícone do seu tipo (¶, H1, o de uma lista), que o transforma em outro tipo; uma imagem colada cai na pasta de assets e no texto. [[ digitado em um bloco, ou Link no menu de blocos, abre um seletor que busca os Blueprints, as tarefas e os assets do projeto, com as palavras digitadas depois de [[ estreitando a busca, e escreve o que você escolhe como um link markdown relativo ao arquivo, do tipo que o ⌘-clique segue e que o eidos move mantém. Uma tabela é editada como uma grade das suas células, cada uma escrita com as teclas de markdown e a barra de formatação: Tab, Enter e as setas percorrem as células e adicionam uma linha depois da última, ⌃⌥ com uma seta adiciona uma linha ou uma coluna ao lado da célula e ⌃⌥⇧ com uma seta a move, os pontos nas bordas de cima e da esquerda adicionam uma coluna ou uma linha onde estão, e uma pílula em uma linha ou coluna abre o seu menu (adicionar, mover, alinhar, limpar, excluir) ou a arrasta para outro lugar; Tabela no menu de blocos escolhe o tamanho em uma grade, linhas coladas de uma planilha preenchem as células, a alça da tabela a abre como o seu markdown, e uma mudança escreve só o que mudou, então as barras de uma tabela alinhada ficam no lugar. Uma seleção mostra acima dela uma barra de formatação (Bold, Italic, Strikethrough, Inline code, Link e o tipo do bloco), que Show format toolbar em Preferences → General → Editing esconde. Um clique em um link edita o seu bloco; ⌘-clique (Ctrl-clique fora de um Mac) o segue como no Reading. Source é o arquivo como texto. Uma quebra de linha que você digita é uma quebra de linha quando a página é lida, como o Obsidian lê uma nota, e uma linha em branco começa um parágrafo novo. Um clique direito em um campo, inclusive nos blocos do editor, mostra o menu do próprio sistema, com as sugestões de ortografia dele.

Em todo modo as propriedades são editadas no lugar como campos tipados, do jeito que o Obsidian mostra: um dropdown onde a propriedade tem opções, pílulas para uma lista (um título longo cortado com reticências, inteiro ao passar o ponteiro), cada uma adicionada a partir de um dropdown que diz o que adiciona (Adicionar blueprint, Adicionar responsável) e que é pesquisável assim que oferece dez ou mais, uma caixa de seleção, um calendário para uma data; uma propriedade declarada que falta no arquivo está a um clique, listada pelo nome (nunca o id que o arquivo já tem, que a barra mostra), e uma que pertence a uma ferramenta aparece travada. Salvar escreve o arquivo no estilo da casa, aplica as regras ao salvar do Linter e roda a verificação nele. O mesmo menu abre o arquivo em cada editor externo que você listou em Preferences, um Abrir em por editor com o nome dele (Abrir em VS Code), ou o mostra no Finder; a paleta também tem Abrir o projeto em Finder e Abrir o projeto em cada editor, para a pasta inteira do projeto.

Salvar, como no VS Code

Um Blueprint, um documento de nível superior, uma tarefa do Backlog e um canvas são editados ao vivo, sem Salvar: o arquivo é gravado quando você para de digitar e quando você sai dele. Cada página aberta no arquivo, nesta janela ou em outra, vê as suas edições enquanto você digita, e uma mudança que um agente, a CLI ou o git grava chega a cada página sem recarregar. As mudanças são combinadas à medida que são feitas, inclusive duas que mexem nas mesmas palavras, então um arquivo ao vivo nunca mostra um conflito; uma mudança de fora do app que cai no bloco que você tem aberto é marcada Alterado fora do app, com Manter e Reverter. Desfazer e refazer (⌘Z, ⇧⌘Z, e Ctrl+Y fora de um Mac) só desfazem as edições feitas naquela página. Se a página perde o servidor do app, ela diz Offline, mantém o que você digita e o combina e grava quando o servidor volta. Num projeto do Eidos online o mesmo vale para todos que estão nele.

Todo o resto, um rascunho, um rascunho de tarefa, um registro guardado como arquivo e um arquivo que a página não consegue manter ao vivo (um preso por um merge ou rebase do git, ou um que outro servidor do Eidos nesta máquina tem aberto), é salvo como o VS Code salva. Uma edição fica guardada na página até ser salva, como o VS Code guarda as alterações de um editor: pelo salvamento automático, um segundo depois que você para de digitar, a não ser que escolha outra coisa, ou por Salvar do menu Arquivo (⌘S, ou Ctrl+S fora de um Mac, para o editor que está na frente) e Salvar tudo (⌥⌘S, ou Ctrl+Alt+S). Nenhum editor mostra um botão de Salvar ou de Reverter: Salvar, Salvar tudo e Reverter arquivo ficam no menu Arquivo do app, no topo do menu que um clique direito na barra de cima abre, e na paleta. Enquanto um item tem alterações, o título e a aba dele mostram um ponto, e Reverter arquivo (ou Reverter as alterações no ⋮) traz de volta o que o arquivo tem. Desfazer e refazer (⌘Z, ⇧⌘Z, e Ctrl+Y fora de um Mac) percorrem o que você fez desde que abriu o item, inclusive através do que já foi salvo.

Uma edição não salva fica com a sua aba: se você for para outro lugar, o item continua na própria aba, a página para onde você foi abre ao lado, e ao voltar você encontra a edição onde a deixou. Fechar a aba ou o modal dele, mudar para outro modo ou recarregar pergunta Salvar, Não salvar ou Cancelar, uma vez só para tudo o que está sem salvar. Um salvamento que falha mantém a edição e diz por quê. Quando o arquivo muda no disco enquanto está aberto (um agente, a CLI, o git, outro editor), um item que você não editou pega a mudança no lugar e nada é gravado. Um item com uma edição a mantém, e o próximo salvamento dele é combinado com a mudança, então a sua edição e a deles ficam as duas no arquivo. Um salvamento que não pode ser combinado é recusado e aparece como conflito: quando os dois lados mudaram as mesmas palavras, durante um merge ou rebase do git (inclusive um pull pelo Source control), num arquivo com marcadores de conflito ou num arquivo esvaziado por fora. O item avisa então que o arquivo mudou, e o salvamento automático espera por você: Recarregar pega o arquivo e descarta a sua edição, e Ficar com o meu grava o seu por cima no próximo salvamento. Uma tarefa movida para outro id ou outro lugar, um rascunho movido entre compartilhado e pessoal, e um registro com um id novo não são combinados. A combinação é do app: um salvamento pela CLI é recusado se o arquivo mudou por baixo dele, como antes, e quando dois servidores do Eidos têm o mesmo projeto aberto numa máquina, só o primeiro combina. Um arquivo que mudou sem nenhum app aberto é combinado na próxima vez que o app o lê ou o salva.

O salvamento automático é uma preferência (Preferences → General), com as quatro configurações do VS Code:

Configuração	O que faz
Após um intervalo (o padrão)	É salvo depois do intervalo do salvamento automático (1000 milissegundos, a não ser que você defina outro) desde a última alteração.
Desativado	Um editor com alterações só é salvo com Salvar ou Salvar tudo; a aba dele mantém o ponto e fechá-la pergunta.
Ao mudar o foco	É salvo quando o editor perde o foco: você clica em outra parte da página, abre outro item, troca de aba ou sai da janela.
Ao mudar de janela	É salvo quando a janela perde o foco.

Com o salvamento automático ligado, fechar uma aba ou sair salva o que está pendente em vez de perguntar. Um salvamento que renomeia o arquivo (o título novo de uma tarefa) leva o leitor ao nome novo, e sair logo em seguida nunca o perde nem traz você de volta. Um salvamento gravado como foi enviado nunca faz a página ler o arquivo de novo: a página reconhece o próprio salvamento quando a alteração volta do disco, enquanto uma alteração feita por qualquer outra pessoa aparece na hora. Um salvamento combinado é lido de volta, então o seu próximo salvamento é feito sobre o arquivo combinado.

Um bloco de código marcado com uma linguagem (```ts, ```yaml, ```bash e o resto das gramáticas do Shiki) é colorido com as cores do tema em Reading, nos blocos desenhados do editor e em qualquer outro lugar onde a página mostra markdown; um bloco sem linguagem fica sem cor. Um bloco marcado como mermaid é desenhado como o seu diagrama, com as cores e a fonte da página, e desenhado de novo quando o tema ou o lado claro e escuro muda. O arquivo guarda o texto: no editor, um clique no diagrama o abre, Diagram no menu de blocos insere um, e um bloco que não pode ser lido mostra o seu texto com o erro do Mermaid embaixo. Export to PDF…, no ⋮ de um Blueprint, um documento, um rascunho ou uma tarefa, grava o arquivo aberto como PDF, com ou sem o seu título e as suas propriedades, no tamanho de página, orientação, margem e escala que você escolher; o app pergunta onde salvá-lo.

Rascunhos

Um Blueprint pode começar antes de pertencer a uma coleção: o botão Draft do formulário New (New spec, New video: com o nome da coleção escolhida), Shared ou Local no seu menu, mantém o arquivo com a CLI, compartilhado com o projeto ou local, fora de qualquer índice e verificação até que Publish o mova para a sua coleção sob as regras de new. Os rascunhos têm um grupo na visão Core do projeto e uma página própria; começado dali (o + do grupo, o New da página) o formulário é New draft, cujo Create draft e Enter mantêm o arquivo como rascunho, nunca como Blueprint. eidos draft →

Fazendo o framework crescer enquanto você trabalha

A organização se conquista, não se prepara antes. Quem edita o framework (num projeto que não marca ninguém, todos) adiciona o que o trabalho pede onde o trabalho está, e o framework acompanha:

New collection, o + do grupo Collections: um nome, a palavra para cada item lida dele, e um template inicial com uma única seção Intent obrigatória. A linha de cada coleção mostra New e essa palavra ao passar o ponteiro.
New group… no seletor de grupo do formulário New, mesmo para uma coleção ainda sem agrupamento: o agrupamento começa com o rótulo Group, a propriedade declarada, e os Blueprints da raiz da coleção vão para o grupo.
Promote to framework, o + ao lado de uma propriedade que o framework não declara: o formulário de propriedade abre preenchido, com o tipo lido do valor. Uma propriedade sua é um aviso até ser promovida ou removida, a menos que as configurações do Health Check desliguem Warn on unknown properties.
Uma seção que o template oferece e falta num Blueprint aparece em cinza no lugar dela, com um + que a adiciona. Os templates marcam as seções Required no editor, e um Blueprint novo começa só com elas.

Configurações

A engrenagem abre Settings como visão da barra lateral, com seus grupos nomeados como o VS Code nomeia seus escopos: User (Account, enquanto você está com a conta conectada, e This server, para o dono de um servidor de equipe; Preferences, Appearance, Hot keys, seus em todo projeto) e Workspace (os deste projeto: Framework, Health Check com os achados da verificação e as suas correções, Corrigir tudo o que for possível no topo, que aplica todas as correções de uma vez depois de listá-las e deixa uma troca de id, um arquivo renomeado ou um valor removido até você marcá-lo, contando as correções em uma barra enquanto são aplicadas, e uma aba Settings para o modo estrito e as regras de seções; Users, Built-in plugins, Community plugins, Registry). Framework abre o documento do Framework (a estrutura) como formulários (Projeto, Folders, Templates, Properties, Vocabulary, Roles, Me, cada página um rascunho até Save to Framework), e enquanto uma de suas páginas está aberta Settings se torna a barra lateral própria do Framework, suas páginas sob um caminho de volta à página de onde você veio. Em Users, New role… ao pé do Role de uma pessoa abre Roles, que edita um papel como o padrão o escreve: quem é a pessoa, as diretrizes às quais um agente se ajusta e a calibração. Criar com IA ali faz um para você: diga para quem é o papel, depois Perguntar à sua IA (o Agente de IA, em uma sessão própria) ou Copiar o prompt para qualquer IA, e cole a resposta; o papel é criado com um nome que nenhum outro papel tem, e você pode mudá-lo depois de criado. Me, no Framework, mostra as diretrizes do seu papel com os seus valores padrão, e o que você escreve para uma vira uma linha sob Calibration no seu me.md. As configurações de um plugin se abrem na engrenagem ao pé da sua própria visão ou na engrenagem de Plugins, e Settings mostra então apenas as seções desse plugin, sob um caminho de volta à página de onde você as abriu, que se mantém quando você passa às configurações de outro plugin; a sua página nesta documentação é o botão Docs no cabeçalho das configurações do plugin. Uma configuração que você muda em qualquer uma dessas páginas mostra o novo valor na hora e o mantém enquanto é salva; ela só volta se o salvamento falhar, e uma notificação diz por quê.

As páginas do Framework, Users e as configurações compartilhadas de cada plugin são mudadas por um editor do Framework. Para qualquer outra pessoa elas podem ser lidas mas não mudadas, e Editar no cabeçalho da página propõe tornar editor o usuário como quem você age; quando você já é, a página edita direto. Um projeto que não marca ninguém como editor deixa todos serem. Uma configuração mantida nesta máquina (local) nunca fica bloqueada.

Users: num projeto do Eidos online, primeiro os Membros, cada um com o seu acesso; depois as pessoas que trabalham no projeto (nome, @alias, papel, email, um seletor Acesso com Nenhum, Editor ou Proprietário, e um interruptor Agente para um agente de IA que comenta como si mesmo), armazenadas em settings.yaml; eidos users as lista, eidos users add adiciona uma e eidos users set define o acesso. Um proprietário é sempre editor, só um proprietário concede ou tira Proprietário, e o avatar e as @menções de um proprietário levam uma estrela. O usuário com que você atua se destaca onde quer que seja nomeado: o avatar dele ganha um anel na cor de destaque, e o nome dele, as pílulas de responsável, as @menções a ele e a linha dele aqui ficam nessa cor. O usuário próprio de um plugin, o @agent do Agente de IA, aparece como do plugin: o nome, o alias e o papel são só de leitura, não tem email nem acesso, e fica enquanto o plugin está ligado. Acting as escolhe como quem esta máquina assina comentários, só entre as pessoas: um agente age pelo terminal com --as, então não é oferecido ali. Atribuição, não autenticação.
Hot keys: uma tecla, ou Definir tecla em uma linha sem tecla, abre um editor de teclas que grava a próxima tecla que você pressiona sem executá-la (uma que outro comando usa, e no app de desktop a tecla de um menu, é gravada, não executada) e diz se ela está livre, se já é do comando ou se é de outro comando, do qual Sobrescrever e salvar a tira, deixando-o sem tecla. Com um agente configurado, Sugerir uma tecla com IA pede ao Agente de IA três teclas livres que combinem com o comando, cada uma com o seu motivo. Buscar por tecla, ao lado da busca, mostra o comando que usa uma tecla que você pressiona, ou diz que ela está livre.
Plugins: cada plugin com o seu interruptor, a sua descrição e as suas configurações como formulário; uma configuração marcada local fica nesta máquina. Plugins →
Preferences: a aparência, organizada como a Aparência do Obsidian: o esquema de cores base (Adaptar ao sistema, Claro ou Escuro), uma cor de destaque, um tema (o padrão, um incluído com o Eidos como Catppuccin, AnuPpuccin, Nord, Gruvbox, Tokyo Night ou Ledger, ou um seu, feito no editor de temas com o lado claro ao lado do escuro, importado de um arquivo CSS ou de um cofre do Obsidian, e exportado como um único arquivo CSS), as fontes da interface, do texto e monoespaçada, o tamanho do texto ao ler e editar, e Ctrl com a roda do mouse para mudá-lo; depois o idioma (inglês, espanhol ou português, ou o que o seu sistema pedir), a visão padrão, a largura da página (Fixed ou Fluid, também Change default page width to na paleta), as teclas da paleta, o canto em que as notificações aparecem (em cima à direita por padrão), os editores externos (quantos você quiser, cada um com um nome e um comando, escolhidos entre os mais comuns como VS Code, Cursor, Zed ou Sublime Text, ou digitados), se as notas da versão aparecem depois de uma atualização, se o quadro do Backlog desenha cada subtarefa como um cartão (Show subtasks on the board, desligado por padrão), se a foto de cada pessoa vem do Gravatar onde as iniciais dela são desenhadas (Show Gravatar pictures, ligado por padrão: a página envia ao gravatar.com um hash SHA-256 do e-mail de cada usuário, nunca o e-mail, e mantém as iniciais para quem não tem foto, e-mail ou rede; um agente nunca é consultado e usa a marca do agente, um brilho na cor de destaque; desligado, nada é enviado), e a ordem dos grupos e atividades da barra lateral. Eu salva quem você é em todos os projetos (seu nome, seu email, sua capacidade técnica e como você gosta de ser ajudado), copiado para o me.md de cada projeto; Perguntar à sua IA o preenche a partir do Agente de IA para você revisar, e Copiar o prompt faz a mesma pergunta a qualquer IA. Relatórios de uso e erros, em Preferences → General, desliga os relatórios anônimos do que é usado e do que falha, e mostra cada relatório como saiu desta máquina. Privacidade →
Novidades: cada versão com sua manchete e um resumo de uma frase, e uma página para cada uma, com suas entradas agrupadas em Novo, Melhorado, Alterado e Corrigido, a partir da página de versões. Depois de uma atualização, a página abre uma vez a da versão nova, com as versões que você pulou; What’s New na paleta lista todas, Show Release Notes abre a sua, e a Home termina com ela.

Tudo o que o app lembra é YAML em .eidos/plugins/eidosmd/: settings.yaml e o views.yaml das visões compartilhadas viajam com o projeto, local.yaml é seu e ignorado pelo git (assim como uma pasta local/ ao lado). Nada fica no armazenamento do navegador nem em um banco de dados.

O Registro

Registry, sob Workspace em Settings e na paleta, é o Registro dentro da página: cada Framework publicado lá, como uma tabela de nome e descrição, categoria, coleções e instalações nos últimos 30 dias, com um filtro de categoria e uma busca à esquerda. Uma linha abre o Framework sobre a tabela (Abrir nesta aba para a sua própria página, /registry/@owner/name): as suas coleções com o template (o modelo) de cada variant (a variante) como o arquivo que é, os seus papéis, documentos de nível superior, propriedades e README, cada peça marcada conforme este projeto a tem: de jeito nenhum, igual ou de outra forma.

A página de um Framework separa as suas peças em Novo neste projeto, O seu é diferente e Já está aqui, e O que muda lista o que incluir as escolhidas escreveria. Cada peça que falta ao projeto já começa marcada; desmarque as que quiser, ou escolha uma só, como eidos install <package> --variant … pega uma. Uma propriedade vem com a sua coleção, ou com tudo o que é novo (--all). Uma peça que o projeto tem de outra forma mantém a sua, a não ser que você escolha Usar o do framework em vez de Manter o seu. O botão diz quantas peças inclui (Incluir 3 peças), e o que chega é exatamente o que eidos install <package> --collection … --on-conflict … --yes escreve: o índice reescrito, a verificação executada, a procedência registrada e a única requisição de contagem de instalações enviada. eidos install →

Quando o Registro não pode ser alcançado, nada é listado e nada pode ser incluído; Try again pergunta de novo. Um README é mostrado com o seu HTML como texto e as suas imagens como links, então a página continua sem carregar nada de fora.

A página lista Frameworks. Os plugins de fora do pacote e as configurações de plugins aparecem no Registro e são instalados pelo terminal, eidos plugin install @owner/name e eidos install @owner/name. Plugins de fora →

Canvas

Uma atividade própria, que lista cada canvas com as suas páginas. Um canvas é um quadro branco de páginas onde um nó é um esboço (uma ideia que ainda não é um Blueprint), um Blueprint (desenhado ao vivo a partir do seu arquivo), um adesivo ou texto livre, com fluxos entre eles, molduras em volta de regiões e threads de comentários fixados em qualquer coisa. Um esboço é promovido a Blueprint pelo mesmo esqueleto que eidos new e mantém o seu lugar. Os nós são estilizados pelas propriedades do próprio Framework. Uma página é exportada como PNG, SVG ou JSON Canvas para o Obsidian.

Navegando o canvas → é o manual: cada ferramenta, gesto, atalho e o arquivo em disco.

Como ele é construído

Um app Preact distribuído no Eidos MD como arquivos estáticos, servido pelo módulo http do próprio Node com uma API JSON sob /api/ (as rotas de um plugin sob /api/plugins/<name>/), vinculado só à interface de loopback. Sem recursos externos, então funciona offline. A busca usa texto completo do SQLite (node:sqlite com o módulo FTS5, no Node que o app traz, nada para compilar).