{"id":43814610,"url":"https://github.com/kpiljoong/tome","last_synced_at":"2026-02-06T00:13:13.229Z","repository":{"id":293305018,"uuid":"976398984","full_name":"kpiljoong/tome","owner":"kpiljoong","description":"Zero-runtime, append-only journal \u0026 blob store for files. Save, search, sync, and share file snapshots locally or remotely (S3, GitHub). Portable, developer-friendly CLI.","archived":false,"fork":false,"pushed_at":"2025-05-14T17:00:36.000Z","size":97,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-14T17:41:56.959Z","etag":null,"topics":["append-only","backup-tool","blobstore","cli","developer-tool","file-sync","go","journal","local-first","s3"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kpiljoong.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-02T03:32:24.000Z","updated_at":"2025-05-14T17:00:30.000Z","dependencies_parsed_at":"2025-05-14T17:51:58.994Z","dependency_job_id":null,"html_url":"https://github.com/kpiljoong/tome","commit_stats":null,"previous_names":["kpiljoong/tome"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/kpiljoong/tome","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kpiljoong%2Ftome","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kpiljoong%2Ftome/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kpiljoong%2Ftome/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kpiljoong%2Ftome/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kpiljoong","download_url":"https://codeload.github.com/kpiljoong/tome/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kpiljoong%2Ftome/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29140053,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-05T23:14:48.546Z","status":"ssl_error","status_checked_at":"2026-02-05T23:14:35.724Z","response_time":65,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["append-only","backup-tool","blobstore","cli","developer-tool","file-sync","go","journal","local-first","s3"],"created_at":"2026-02-06T00:13:06.417Z","updated_at":"2026-02-06T00:13:13.213Z","avatar_url":"https://github.com/kpiljoong.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Tome\n\n\u003c!-- badges: start --\u003e\n[![Licence](https://img.shields.io/github/license/mashape/apistatus.svg)](https://choosealicense.com/licenses/mit/)\n![Badge](https://hitscounter.dev/api/hit?url=https%3A%2F%2Fgithub.com%2Fkpiljoong%2Ftome\u0026label=Visitor\u0026icon=github\u0026color=%23198754)\n\u003c!-- badges: end --\u003e\n\n**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).\n\n## Features\n\n- **Snapshot** files into an append-only journal\n- **Search** by filename or full path\n- **Sync** with remote storage (S3, GitHub support)\n- **Share** files with temoporary or shortened URLs\n- **Organize** with namespaces (like Git branches)\n- Minimal dependencies, portable CLI tool\n\n## Installation\n\n```bash\ngo install github.com/kpiljoong/tome@latest\n```\n\nOr download binaries from [Releases](https://github.com/kpiljoong/tome/releases) for Windows, macOS, and Linux.\n\n## Usage\n\n### Save a file\n\n```bash\ntome save workbooks plan.json\n```\n\n### Search entries\n\n```bash\ntome search workbooks plan\n```\n\n### List namespace entries\n\n```bash\ntome ls workbooks\n```\n\n### Get the latest version\n\n```bash\ntome latest workbooks plan.json --output ./restored.json\n```\n\n### Sync with S3\n\n```bash\ntome sync --to s3://your-bucket/prefix\n```\n\n### Status check\n\n```bash\ntome status --from s3://your-bucket/prefix --json\n```\n\n### Share a file\n\n```bash\ntome share workbooks plan.json --from s3://your-bucket/prefix --shorten\n```\n\n### Terminal UI (TUI)\n\nYou can browse saved journal entries in a terminal interface:\n\n```bash\ntome tui\n```\n\n## Configuration\n\nCreate a config file at `~/.tome/config.yaml`:\n\n```yaml\ndefault_remote: s3://your-bucket/prefix\n```\n\n## Structure\n\n- `.tome/` - Local store\n  - `blobs/` - Content-addressed file blobs\n  - `journals/\u003cnamespace\u003e/` - Journal entries as JSON\n- Remotes (S3/GitHub) mirror the same layout\n\n## Testing\n\n```bash\ngo test ./...\n```\n\n## License\n\n[![MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/kpiljoong/tome/blob/master/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkpiljoong%2Ftome","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkpiljoong%2Ftome","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkpiljoong%2Ftome/lists"}