anywrite

Visão Geral

anywrite é uma CLI compilada em um único arquivo Bun/TypeScript para a API HTTP local do aplicativo desktop Anytype — todos os 52 endpoints para espaços, objetos, propriedades, tags, tipos, modelos, listas, chat, arquivos, membros, pesquisa e autenticação — como um único binário sem dependências de tempo de execução. Ele existe como uma alternativa de baixo contexto ao servidor MCP oficial do Anytype: em vez de expor 52 ferramentas sempre carregadas para cada sessão de agente, anywrite é uma CLI normal conectada como uma habilidade que custa zero contexto até ser realmente invocada, e é igualmente utilizável de um terminal ou de qualquer script.

Quando Usar Esta Habilidade

• Use quando o usuário mencionar Anytype ou pedir para criar, atualizar, pesquisar ou organizar notas, tarefas ou objetos PKM.
• Use ao trabalhar com espaços, propriedades, tags, tipos, modelos ou listas (conjuntos e coleções) do Anytype.
• Use quando o usuário pedir para fazer upload de arquivos para um espaço, conversar dentro de um espaço ou ler/escrever objetos estruturados programaticamente.

Como Funciona

Etapa 1: Garanta que o desktop Anytype esteja em execução e autenticado

Este repositório não distribui o executável anywrite. O usuário deve instalar ou compilar uma versão upstream revisada fora do espaço de trabalho atual e fornecer seu caminho absoluto explícito. Antes de usar, verifique se o caminho é um arquivo regular executável, não é um link simbólico e não é um artefato dist/ relativo ao espaço de trabalho. Nunca descubra ou execute automaticamente ./dist/anywrite do repositório em que está trabalhando.

O aplicativo desktop Anytype deve estar em execução localmente (padrão http://localhost:31009). Autentique uma vez:

"/absolute/path/to/anywrite" auth --status        # shows configured yes/no and where the key came from
"/absolute/path/to/anywrite" auth                 # challenge flow — a 4-digit code appears in the app
"/absolute/path/to/anywrite" auth --code 1234     # non-interactive form of the same exchange

A chave é escrita em ~/.anywrite/config.json e nunca é impressa por nenhum comando.

Etapa 2: Invoque um recurso + ação

anywrite <resource> <action> [positionals] [--flag value]

Recursos: spaces, objects, properties, tags, types, templates, lists, files, members, search, chat, auth. A saída é JSON por padrão; adicione --pretty para uma visualização humana, --json como uma saída de emergência para qualquer coisa que as flags tipadas ainda não modelam. Posicionais space/type/property aceitam um nome ou um ID — nomes são resolvidos para IDs automaticamente.

Exemplos

Exemplo 1: Criar e atualizar um objeto

"/absolute/path/to/anywrite" objects create <space> --type task --name "Buy milk"
"/absolute/path/to/anywrite" objects update <space> <object_id> --status "Done"

Exemplo 2: Pesquisar e fazer upload de um arquivo

"/absolute/path/to/anywrite" search global --query "task" --types task
"/absolute/path/to/anywrite" files upload <space> --file ./image.png

Exemplo 3: Ler mensagens de chat

"/absolute/path/to/anywrite" chat messages <space> <chat_id> --all

Melhores Práticas

• ✅ Passe nomes para space/type/property e deixe a CLI resolvê-los para IDs.
• ✅ Use a saída JSON padrão para scripts e --pretty para revisão humana.
• ✅ Recorra a --json quando um campo de API totalmente novo ainda não for coberto por uma flag tipada.
• ❌ Não defina um emoji de string vazia --icon; omita a flag completamente em vez disso.
• ❌ Não espere que lists add/remove funcionem em conjuntos — eles se aplicam apenas a coleções.

Limitações

• Esta habilidade não substitui a validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se os inputs, permissões ou limites de segurança necessários estiverem faltando.
• Limitado pela própria API local do Anytype: sem edição em nível de bloco (o corpo é apenas substituição completa de markdown), sem gerenciamento de convite/papel de membro, sem criação/atualização/exclusão de modelo, sem exclusão de espaço.
• O campo do corpo do objeto é nomeado --body na criação, mas --markdown na atualização.

Notas de Segurança e Proteção

• A chave da API é armazenada localmente em ~/.anywrite/config.json e nunca é impressa por nenhum comando, incluindo auth --status.
• Precedência de configuração em tempo de execução: variável de ambiente ANYTYPE_API_KEY, depois ~/.anywrite/config.json, depois um fallback somente leitura para um ~/.anytype-cli/config.yaml existente.
• Todas as operações visam uma instância desktop Anytype em execução localmente; nenhum dado é enviado para servidores de terceiros.
• Excluir é um arquivamento suave em todos os lugares e é idempotente — uma exclusão repetida permanece 200, nunca 410.

Armadilhas Comuns

…