{"id":21651092,"url":"https://github.com/iansinnott/bitbucket-cli","last_synced_at":"2026-05-18T03:10:45.966Z","repository":{"id":33076965,"uuid":"36713807","full_name":"iansinnott/bitbucket-cli","owner":"iansinnott","description":"A CLI for BitBucket","archived":false,"fork":false,"pushed_at":"2015-06-02T15:49:27.000Z","size":124,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-12T18:47:12.358Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iansinnott.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-06-02T06:47:24.000Z","updated_at":"2018-09-24T22:44:55.000Z","dependencies_parsed_at":"2022-09-12T18:23:51.077Z","dependency_job_id":null,"html_url":"https://github.com/iansinnott/bitbucket-cli","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/iansinnott/bitbucket-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iansinnott%2Fbitbucket-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iansinnott%2Fbitbucket-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iansinnott%2Fbitbucket-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iansinnott%2Fbitbucket-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iansinnott","download_url":"https://codeload.github.com/iansinnott/bitbucket-cli/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iansinnott%2Fbitbucket-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33163438,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T22:39:12.733Z","status":"online","status_checked_at":"2026-05-18T02:00:06.436Z","response_time":71,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2024-11-25T07:46:41.140Z","updated_at":"2026-05-18T03:10:45.950Z","avatar_url":"https://github.com/iansinnott.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BitBucket CLI (Node.js)\n\nThis is a CLI for interacting with [BitBucket][bb].\n\n[bb]: https://bitbucket.org/\n\nCurrently it only supports listing and creating repositories.\n\n## Usage\n\nList all your repositories (public \u0026 private):\n\n```\n$ bb list\n```\n\nCreate a new private repo with a description:\n\n```\n$ bb create my-super-repo -D \"This is the repo description\"\n```\n\nTo create a public repo, use the `-P` option:\n\n```\n$ bb create my-super-repo -P\n```\n\n## Full API\n\n#### `list`\n\nList all of your public and private repos:\n\n```\n$ bb list\n```\n\n`list` takes no options.\n\n#### `create`\n\n```\n$ bb create [name] [options]\n```\n\nThe name argument is required.\n\n`create` has two options:\n\n* `-D, --description [string]`: Specify the repository description. \n* `-P, --public`: Make the repository public (defaults to false)\n\n**That's right.** Just _two_ commands.\n\n### Other Options\n\n#### `--version`\n\nDisplay the version number.\n\n#### `--help`\n\nDisplay the help text.\n\n## Authentication\n\nTo take actions on your behalf, the CLI needs your username and password. To give it the information it needs you have a number of options:\n\n#### Configuration file\n\nCreate a `.bitbucketrc` file at your user root. On a Mac or Linux you could create the file with `touch`:\n\n```\n$ touch ~/.bitbucketrc\n```\n\nThen add the following configuration code to the file. Don't forget to use your own username and password, otherwise BitBucket will give you an authentication error.\n\n```js\n// ~/.bitbucketrc\nmodule.exports = {\n  username: '\u003cyour username or email here\u003e',\n  password: '\u003cyour password here\u003e'\n};\n```\n\n#### Using environment variables:\n\n```\n$ export BITBUCKET_USERNAME=\u003cusername\u003e\n$ export BITBUCKET_PASSWORD=\u003cpassword\u003e\n$ bb create some-repo\n```\n\n#### Inline environment variables\n\n```\n$ BITBUCKET_USERNAME=\u003cusername\u003e BITBUCKET_PASSWORD=\u003cpassword\u003e bb list\n```\n\nWith this approach, you will have to write our your username and password every time, but you could always create an alias if you prefer.\n\n#### A note on storing plain-text passwords\n\nIt's not a good idea to store plane-text passwords on your computer in case someone gained access to your hard drive. That being said, it really adds a lot of convenience, so just no the risks if you decide to store your password anywhere on your system in a human-readable form.\n\nThis script will never store your password and it only ever sends it to BitBucket. If you're not convinced feel free to read the code. As of this writing its only a few hundred lines so it should be a really quick read :)\n\n## Infrequently Asked Questions\n\n**Q:** _Will this ever support OAuth instead of Basic Auth_\n\n**A:** Maybe! I just wanted to get something up and running quickly and using Basic Auth was the best way to do that.\n\n**Q:** _There are other CLIs out there, why build a new one?_\n\n**A:** Initially I didn't find one for Node.js.\n\n**Q:** _Is this affiliated with BitBucket or Atlassian in any way?_\n\n**A:** Nope. I'm pretty sure they would implement more than two commands if they rolled their own CLI. They also probably wouldn't host it on GitHub. :wink:\n\n**Q:** _Why is this hosted on GitHub?_\n\n**A:** Because GitHub already has an [outstanding CLI tool][hub] for making repositories on the fly.\n\n[hub]: https://hub.github.com/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiansinnott%2Fbitbucket-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiansinnott%2Fbitbucket-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiansinnott%2Fbitbucket-cli/lists"}