Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

tes create

Criar uma tessera a partir de um diretório de arquivos.

Uso

tes create <CAMINHO> [OPÇÕES]

Argumentos

ArgumentoDescrição
<CAMINHO>Diretório contendo os arquivos a incluir

Opções

OpçãoDescriçãoPadrão
-n, --non-interactivePular promptsdesativado
--dry-runPré-visualizar o que seria incluídodesativado
--visibility <VALOR>Nível de visibilidade: public, private, circlepublic
--language <CÓDIGO>Código de idioma (ex.: en, pt-BR)en
--tags <LISTA>Tags separadas por vírgulanenhuma
--location <DESC>Descrição do localnenhuma
--data-dir <CAMINHO>Diretório base para armazenamento de dados~/.tesseras

Formatos de arquivo suportados

ExtensãoTipoTipo de memória
.jpg, .jpegImagem (JPEG)Momento
.pngImagem (PNG)Momento
.wavÁudio (WAV PCM)Momento
.webmVídeo (WebM)Momento
.txtTexto puro (UTF-8)Reflexão

Arquivos com outras extensões são ignorados.

Inferência de tipo de memória

O comando atribui automaticamente um tipo de memória baseado no formato do arquivo:

  • Arquivos de texto (.txt) são classificados como Reflexão — pensamentos, crenças ou opiniões
  • Todos os outros formatos são classificados como Momento — uma foto, gravação ou vídeo de algo acontecendo

Exemplos

Pré-visualizar antes de criar

tes create ./minhas-fotos --dry-run

Criar com metadados

tes create ./ferias-2026 \
    --tags "ferias,verao,praia" \
    --location "Florianópolis, Brasil" \
    --language pt-BR \
    --visibility public

Modo não-interativo

tes create ./diario --non-interactive --tags "cotidiano"

Níveis de visibilidade

NívelQuem pode acessar
publicQualquer pessoa (padrão)
privateApenas você (e herdeiros designados)
circlePessoas explicitamente escolhidas

O que acontece internamente

  1. Varre o diretório em busca de arquivos suportados
  2. Calcula um hash BLAKE3 para cada arquivo
  3. Atribui um tipo de memória baseado na extensão do arquivo
  4. Gera um MANIFEST listando todos os arquivos com seus checksums
  5. Assina o MANIFEST com sua chave privada Ed25519
  6. Armazena os arquivos e metadados no banco de dados local
  7. Exibe o hash de conteúdo que identifica unicamente esta tessera