Tome

Tome is a zero-runtime, append-only journal and blob store for files. Designed for developers and systems alike, it lets you save, search, sync, and share file snapshots efficiently — both locally and remotely (e.g., S3, GitHub).

Features

• Snapshot files into an append-only journal
• Search by filename or full path
• Sync with remote storage (S3, GitHub support)
• Share files with temoporary or shortened URLs
• Organize with namespaces (like Git branches)
• Minimal dependencies, portable CLI tool

Installation

go install github.com/kpiljoong/tome@latest

Or download binaries from Releases for Windows, macOS, and Linux.

Usage

Save a file

tome save workbooks plan.json

Search entries

tome search workbooks plan

List namespace entries

tome ls workbooks

Get the latest version

tome latest workbooks plan.json --output ./restored.json

Sync with S3

tome sync --to s3://your-bucket/prefix

Status check

tome status --from s3://your-bucket/prefix --json

Share a file

tome share workbooks plan.json --from s3://your-bucket/prefix --shorten

Terminal UI (TUI)

You can browse saved journal entries in a terminal interface:

tome tui

Configuration

Create a config file at ~/.tome/config.yaml:

default_remote: s3://your-bucket/prefix

Structure

• .tome/ - Local store
  • blobs/ - Content-addressed file blobs
  • journals/<namespace>/ - Journal entries as JSON
• Remotes (S3/GitHub) mirror the same layout

Testing

go test ./...

License