{"id":13432467,"url":"https://github.com/erdos-one/r2","last_synced_at":"2025-03-17T09:31:28.673Z","repository":{"id":65423977,"uuid":"589107635","full_name":"erdos-one/r2","owner":"erdos-one","description":"☁️ Command Line Interface for Cloudflare R2 Storage","archived":false,"fork":false,"pushed_at":"2023-01-27T17:15:59.000Z","size":59,"stargazers_count":19,"open_issues_count":3,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-27T13:00:46.486Z","etag":null,"topics":["aws-api","cloudflare","cloudflare-r2","cobra-cli","go","r2"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/erdos-one.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2023-01-15T04:22:06.000Z","updated_at":"2024-10-16T08:40:55.000Z","dependencies_parsed_at":"2023-02-12T13:48:06.586Z","dependency_job_id":null,"html_url":"https://github.com/erdos-one/r2","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erdos-one%2Fr2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erdos-one%2Fr2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erdos-one%2Fr2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erdos-one%2Fr2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/erdos-one","download_url":"https://codeload.github.com/erdos-one/r2/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244009076,"owners_count":20382963,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["aws-api","cloudflare","cloudflare-r2","cobra-cli","go","r2"],"created_at":"2024-07-31T02:01:11.999Z","updated_at":"2025-03-17T09:31:28.342Z","avatar_url":"https://github.com/erdos-one.png","language":"Go","readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/erdos-one/r2\"\u003e\n    \u003cimg alt=\"R2 CLI\" src=\"assets/bucket.svg\" width=\"150\"/\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003e\n  Cloudflare R2 object storage made easy\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/erdos-one/r2/releases/latest\" title=\"GitHub release\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/release/erdos-one/r2.svg\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://opensource.org/licenses/Apache-2.0\" title=\"License: Apache-2.0\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/License-Apache%202-blue.svg\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n## Purpose\n\n`r2` is a library and command line interface for working with Cloudflare's\n[R2 Storage](https://www.cloudflare.com/products/r2/).\n\nCloudflare's R2 implements the [S3\nAPI](https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html), attempting to allow users and\ntheir applications to migrate easily, but importantly lacks the key, simple-to-use features provided\nby the AWS CLI's [s3 subcommand](https://docs.aws.amazon.com/cli/latest/reference/s3/), as opposed\nto the more complex and verbose API calls of the [s3api\nsubcommand](https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html). This CLI fills that\ngap.\n\n## Installation\n\nTo install the `r2` CLI, simply run the following command:\n\n```bash\ngo install github.com/erdos-one/r2@latest\n```\n\nFor more installation options, see [INSTALL.md](INSTALL.md).\n\n## Usage\n\nTo view the CLI's help message, run:\n\n```bash\nr2 help\n```\n\n### Available Commands\n\n- `r2 configure` — Configure R2 access\n- `r2 cp` — Copy an object from one R2 path to another\n- `r2 help` — Help about any command\n- `r2 ls` — List either all buckets or all objects in a bucket\n- `r2 mb` — Create an R2 bucket\n- `r2 mv` — Moves a local file or R2 object to another location locally or in R2.\n- `r2 presign` — Generate a pre-signed URL for a Cloudflare R2 object\n- `r2 rb` — Remove an R2 bucket\n- `r2 rm` — Remove an object from an R2 bucket\n- `r2 sync` — Syncs directories and R2 prefixes.\n\nTo view the help message for a specific command, run:\n\n```bash\nr2 help \u003ccommand\u003e\n```\n\nFor more usage information — including library usage — see [USAGE.md](USAGE.md).\n\n## Progress\n\nWe're working to implement all the functionality of the AWS CLI's s3 subcommand. As of\n[v0.1.0-alpha](https://github.com/erdos-one/r2/tree/v0.1.0-alpha), we have all the commands\nimplemented, but not all the options. We're working on it, but if you'd like to lend a helping hand,\nwe'd much appreciate your help!\n\nTo view the latest changes, see [CHANGELOG.md](CHANGELOG.md).\n\n## Contributing\n\nOur expected workflow is: Fork → Patch → Push → Pull Request.\n\nAnother helpful way to contribute is to report bugs or request features by opening an issue. We\nappreciate contributions of all kinds!\n\nTo understand the codebase, we recommend reading the [ARCHITECTURE.md](ARCHITECTURE.md) file.\n","funding_links":[],"categories":["Go"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferdos-one%2Fr2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ferdos-one%2Fr2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferdos-one%2Fr2/lists"}