{"id":43784541,"url":"https://github.com/boringcache/save","last_synced_at":"2026-03-10T19:01:23.491Z","repository":{"id":336657802,"uuid":"1049889613","full_name":"boringcache/save","owner":"boringcache","description":"Save directories to BoringCache at a specific point in your workflow.","archived":false,"fork":false,"pushed_at":"2026-03-06T11:33:27.000Z","size":1895,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-06T15:49:25.557Z","etag":null,"topics":["caching","ci","cicd","dependency-management","github-actions","utilities"],"latest_commit_sha":null,"homepage":"https://boringcache.com","language":"TypeScript","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/boringcache.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,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-09-03T16:35:11.000Z","updated_at":"2026-03-06T11:33:28.000Z","dependencies_parsed_at":"2026-03-10T19:01:03.847Z","dependency_job_id":null,"html_url":"https://github.com/boringcache/save","commit_stats":null,"previous_names":["boringcache/save"],"tags_count":35,"template":false,"template_full_name":null,"purl":"pkg:github/boringcache/save","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boringcache%2Fsave","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boringcache%2Fsave/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boringcache%2Fsave/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boringcache%2Fsave/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/boringcache","download_url":"https://codeload.github.com/boringcache/save/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boringcache%2Fsave/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30348853,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T15:55:29.454Z","status":"ssl_error","status_checked_at":"2026-03-10T15:54:58.440Z","response_time":106,"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":["caching","ci","cicd","dependency-management","github-actions","utilities"],"created_at":"2026-02-05T19:01:33.594Z","updated_at":"2026-03-10T19:01:23.479Z","avatar_url":"https://github.com/boringcache.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# boringcache/save\n\nSave directories to BoringCache at a specific point in your workflow. For automatic restore + save, use `boringcache/action` instead.\n\nCaches are content-addressed — identical content is never re-uploaded.\n\n## Quick start\n\n```yaml\n- uses: boringcache/save@v1\n  with:\n    workspace: my-org/my-project\n    entries: deps:node_modules\n  env:\n    BORINGCACHE_API_TOKEN: ${{ secrets.BORINGCACHE_API_TOKEN }}\n```\n\nEntries use `tag:path` format (for example, `deps:node_modules`).\n\n## Mental model\n\nThis action saves directories you explicitly choose.\n\n- You decide what is expensive (dependencies, build outputs, toolchains)\n- BoringCache fingerprints the directory contents\n- If the content already exists, the upload is skipped\n- The cache can be restored anywhere using the same tag\n\nThis action does not infer what should be cached and does not modify your build.\n\n## Common patterns\n\n### Simple CI cache (always save)\n\n```yaml\n- run: npm ci\n- run: npm test\n\n- uses: boringcache/save@v1\n  if: always()\n  with:\n    workspace: my-org/my-project\n    entries: deps:node_modules\n  env:\n    BORINGCACHE_API_TOKEN: ${{ secrets.BORINGCACHE_API_TOKEN }}\n```\n\n### Advanced pattern: Restore + save pair\n\n```yaml\n- uses: boringcache/restore@v1\n  id: cache\n  with:\n    workspace: my-org/my-project\n    entries: deps:node_modules\n  env:\n    BORINGCACHE_API_TOKEN: ${{ secrets.BORINGCACHE_API_TOKEN }}\n\n- run: npm ci\n\n- uses: boringcache/save@v1\n  with:\n    workspace: my-org/my-project\n    entries: deps:node_modules\n  env:\n    BORINGCACHE_API_TOKEN: ${{ secrets.BORINGCACHE_API_TOKEN }}\n```\n\n## Inputs\n\n| Input | Required | Default | Description |\n|-------|----------|---------|-------------|\n| `workspace` | No | repo name | Workspace in `org/repo` form. Defaults to `BORINGCACHE_DEFAULT_WORKSPACE` or repo name. |\n| `entries` | No | - | Comma-separated `tag:path` pairs. Required unless using actions/cache-compatible inputs. |\n| `path` | No | - | Files/directories to save (actions/cache compatible). |\n| `key` | No | - | Cache key (actions/cache compatible). |\n| `enableCrossOsArchive` | No | `false` | Enable cross-OS sharing by disabling platform suffixes (actions/cache compatibility). |\n| `no-platform` | No | `false` | Disable OS/arch scoping for cache tags. |\n| `force` | No | `false` | Overwrite existing cache entries. |\n| `upload-chunk-size` | No | auto | Chunk size for uploads (bytes). |\n| `verbose` | No | `false` | Enable detailed output. |\n\n## Platform behavior\n\nPlatform scoping is what makes it safe to reuse caches across machines.\n\nBy default, caches are isolated by OS and architecture. Use `no-platform: true` or `enableCrossOsArchive: true` only for portable artifacts (sources, lockfiles).\n\n## Environment variables\n\n| Variable | Description |\n|----------|-------------|\n| `BORINGCACHE_API_TOKEN` | API token (required) |\n| `BORINGCACHE_DEFAULT_WORKSPACE` | Default workspace (if not specified in inputs) |\n\n## Migrating from actions/cache/save (optional)\n\n```diff\n- uses: actions/cache/save@v4\n+ uses: boringcache/save@v1\n+ env:\n+   BORINGCACHE_API_TOKEN: ${{ secrets.BORINGCACHE_API_TOKEN }}\n```\n\n## Troubleshooting\n\n- Unauthorized or workspace not found: ensure `BORINGCACHE_API_TOKEN` is set and the workspace exists.\n- Upload skipped: content already exists in cache (this is expected behavior).\n- Force overwrite: use `force: true` to update existing cache entries.\n\n## Release notes\n\nSee https://github.com/boringcache/save/releases.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboringcache%2Fsave","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fboringcache%2Fsave","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboringcache%2Fsave/lists"}