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