Stamp CLI

Stamp CLI is my note-naming assistant for Plaintext Commons vaults and folders. It generates consistent IDs and filenames so humans, agents, and automations can keep a shared corpus tidy without manual bookkeeping.

What it does

Stamp is a single binary that prints filename suggestions to stdout. It is friendly to shell scripts, AI agents, and quick terminal workflows. Common tasks:

• stamp daily produces a YYYY-MM-DD daily note name.
• stamp fleeting outputs a timestamped fleeting note ID.
• stamp project increments project IDs such as P0461-arrowhead-cli.

Each format follows the conventions used across my Project Humane tools, so new notes land in predictable places and link cleanly inside the Plaintext Commons corpus.

Obsidian-aware

Stamp is Obsidian-aware and automatically picks up Daily Notes and Unique Note Creator formats when run inside an Obsidian vault.

Why it exists

I wanted Arrowhead and my AI assistants to agree on the same naming rules without hand-coded prompts. Stamp serves that role:

The side effect is that all automation tools follow same instructions for naming using stamp and thus cross-linking, lookup and note creation is standartized.

Installation

Install via my Homebrew tap:

brew tap totocaster/tap
brew install totocaster/tap/stamp

You can also download release binaries directly from GitHub releases if you prefer manual installs.