+
+
+Create a tessera from a directory of files.
+
+tes create <PATH> [OPTIONS]
+
+
+
+
+
+| Argument | Description |
|---|
+
+
+<PATH> | Directory containing files to include |
+
+
+
+
+
+| Option | Description | Default |
|---|
+
+
+-n, --non-interactive | Skip prompts | off |
+--dry-run | Preview what would be included | off |
+--visibility <VALUE> | Visibility level: public, private, circle | public |
+--language <CODE> | Language code (e.g., en, pt-BR) | en |
+--tags <LIST> | Comma-separated tags | none |
+--location <DESC> | Location description | none |
+--data-dir <PATH> | Base directory for data storage | ~/.tesseras |
+
+
+
+
+
+| Extension | Type | Memory type |
|---|
+
+
+.jpg, .jpeg | Image (JPEG) | Moment |
+.png | Image (PNG) | Moment |
+.wav | Audio (WAV PCM) | Moment |
+.webm | Video (WebM) | Moment |
+.txt | Plain text (UTF-8) | Reflection |
+
+
+
Files with other extensions are ignored.
+
+The command automatically assigns a memory type based on the file format:
+
+- Text files (
.txt) are classified as Reflection — thoughts, beliefs, or opinions
+- All other formats are classified as Moment — a photo, recording, or video of something happening
+
+
+
+tes create ./my-photos --dry-run
+
+
+tes create ./vacation-2026 \
+ --tags "vacation,summer,beach" \
+ --location "Florianópolis, Brazil" \
+ --language pt-BR \
+ --visibility public
+
+
+tes create ./daily-log --non-interactive --tags "daily"
+
+
+
+
+
+| Level | Who can access |
|---|
+
+
+public | Anyone (default) |
+private | Only you (and designated heirs) |
+circle | Explicitly chosen people |
+
+
+
+- Scans the directory for supported files
+- Computes a BLAKE3 hash for each file
+- Assigns a memory type based on file extension
+- Generates a MANIFEST listing all files with their checksums
+- Signs the MANIFEST with your Ed25519 private key
+- Stores the files and metadata in the local database
+- Outputs the content hash that uniquely identifies this tessera
+
+
+
+
+
+