Skip to content
/ tome Public

Zero-runtime, append-only journal & blob store for files. Save, search, sync, and share file snapshots locally or remotely (S3, GitHub). Portable, developer-friendly CLI.

License

Notifications You must be signed in to change notification settings

kpiljoong/tome

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tome

Licence Badge

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

MIT

About

Zero-runtime, append-only journal & blob store for files. Save, search, sync, and share file snapshots locally or remotely (S3, GitHub). Portable, developer-friendly CLI.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published