O NIP-CD define comandos de barra (slash commands). Um serviço publica um comando, e qualquer pessoa pode invocá-lo como texto simples no conteúdo de qualquer event Nostr. Trata-se de uma especificação opcional em rascunho. O NIP-CD foi incorporado em 21 de outubro de 2026 com o título Commands, depois de uma proposta anterior, e passou a se chamar Slash Commands quando as listas opcionais de comandos instalados foram incorporadas, em 27 de outubro de 2026.

Como funciona

Um comando é definido por um event de kind 31992. As tags obrigatórias informam a palavra de acionamento sem a barra, um título e uma descrição de uso. Tags arg ordenadas declaram argumentos posicionais, com tipos como pubkey, event, relay, number, enum ou text. Com tags s, é possível limitar quais events acionam o comando por kind, relay, autor ou tag. Esses escopos funcionam como um filtro: valores do mesmo tipo são alternativas, e todo tipo presente precisa corresponder.

Uma invocação é um texto que começa no índice 0 do conteúdo de um event, como /ban seguido de argumentos, e não contém tags. Ao acrescentar um qualificador no formato @nostr:npub1..., a invocação se dirige a um único executor. Sem qualificador, qualquer comando cujo gatilho corresponda e cujo escopo inclua o event pode agir, de modo que uma única mensagem pode acionar vários serviços.

O suporte nos clientes é opcional. Eles podem oferecer preenchimento automático, seletores de argumentos e chips renderizados. Os clientes não devem exigir o próprio suporte antes de enviar uma invocação, e devem enviar como conteúdo comum o texto que não puder ser interpretado.

Em grupos baseados em relay, definições e invocações vão para o relay do grupo. No uso por difusão, as definições vão para as outboxes dos executores, e as invocações, para as inboxes dos executores.

Listas de comandos instalados

Cada usuário pode manter uma lista opcional de kind 10992, conforme o NIP-51, com tags a que apontam para definições de comando de kind 31992 pela pubkey do executor e pelo valor d, com uma dica de relay opcional. Os clientes deveriam usar a lista para o preenchimento automático e os chips renderizados. O que a lista registra é uma preferência de exibição e descoberta do usuário. Ela não autoriza nenhum executor, e a invocação em texto simples funciona sem ela. Esta parte da especificação foi incorporada em 27 de outubro de 2026 por meio do PR #2525. O merge não mostra quais clientes implementaram a lista.

Fontes primárias

Mencionado em

Veja também