{"id":20740922,"url":"https://github.com/rollbar/rollbar-cli","last_synced_at":"2026-03-15T20:03:00.126Z","repository":{"id":45061465,"uuid":"285892121","full_name":"rollbar/rollbar-cli","owner":"rollbar","description":null,"archived":false,"fork":false,"pushed_at":"2022-08-23T01:38:15.000Z","size":2046,"stargazers_count":10,"open_issues_count":6,"forks_count":4,"subscribers_count":24,"default_branch":"master","last_synced_at":"2025-04-21T08:44:58.955Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/rollbar.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}},"created_at":"2020-08-07T18:06:32.000Z","updated_at":"2024-09-26T13:35:22.000Z","dependencies_parsed_at":"2022-09-23T10:24:27.693Z","dependency_job_id":null,"html_url":"https://github.com/rollbar/rollbar-cli","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rollbar%2Frollbar-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rollbar%2Frollbar-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rollbar%2Frollbar-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rollbar%2Frollbar-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rollbar","download_url":"https://codeload.github.com/rollbar/rollbar-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250551050,"owners_count":21449125,"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":[],"created_at":"2024-11-17T06:31:14.339Z","updated_at":"2026-03-15T20:03:00.120Z","avatar_url":"https://github.com/rollbar.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# rollbar-cli\n\nThe Rollbar CLI provides easy command line access to Rollbar's API features,\nstarting with source map uploads and notifying deploys.\n\n![build](https://github.com/rollbar/rollbar-cli/workflows/Node.js%20CI/badge.svg)\n\nNote: The official Rollbar CLI supports source map uploads and deployments, but it does not cover the full set of API-driven workflows some teams want. If you are looking for a CLI that wraps the Rollbar REST API, check out these community-maintained projects:\n\u003cull\u003e\n  \u003cli\u003e\u003ca href=\"https://github.com/davebarnwell/rollbar-cli\"\u003ehttps://github.com/davebarnwell/rollbar-cli\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"https://github.com/delexw/rollbar-cli\"\u003ehttps://github.com/delexw/rollbar-cli\u003c/a\u003e\u003c/li\u003e\n\u003c/ul\u003e\n\u003cbr /\u003e\nThese tools are community-maintained (not officially supported by Rollbar). We are linking them because they are actively maintained and have been helpful for customers.\n\n## Install\n\n```\nnpm install -g rollbar-cli\n```\n\n## Usage and Reference\nCurrently upload-sourcemaps and notify-deploy commands are supported.\n\n### upload-sourcemaps\nUpload source maps recursively from a directory.\n\n```\nrollbar-cli upload-sourcemaps \u003cpath\u003e [options]\n\nupload sourcemaps\n\nOptions:\n  --version       Show version number                                  [boolean]\n  -v, --verbose   Verbose status output                                [boolean]\n  -q, --quiet     Silent status output                                 [boolean]\n  --help          Show help                                            [boolean]\n  --access-token  Access token for the Rollbar API           [string] [required]\n  --url-prefix    Base part of the stack trace URLs          [string] [required]\n  --code-version  Code version string must match value in the Rollbar item\n                                                             [string] [required]\n  --next          Next version. Zip all the source map files and upload as one\n                  file                                                 [boolean]\n  -D, --dry-run   Scan and validate source maps without uploading      [boolean]\n```\n\nSome of these options are required and must be specified for a successful upload.\n\n`path`: Absolute or relative path to build directory. This directory should contain .js\nfiles with `sourceMappingURL` directives included. The current version of the CLI\nsupports detecting files with `sourceMappingURL` directives and uploading related\nmap files within a directory.\n\n`--access-token`: The Rollbar API `post_server_item` token.\n\n`--url-prefix`: The base portion of the URL to be concatenated with the js filenames\ndiscovered while scanning `path`. The Rollbar backend uses this to match stack frame locations\nand it must exactly match the URLs in the error stack frames. See `minified_url` at\n[Source Maps](https://docs.rollbar.com/docs/source-maps) for more information.\n\n`--code-version`: The code version string must match the string passed in the Rollbar\nerror payload, which is usually set in the config options for Rollbar.js.\nSee [Source Maps](https://docs.rollbar.com/docs/source-maps) for more information.\n\n`--next`: This is an optional parameter triggering next version. When specified, all source map files\nare compressed and uploaded as one zip file directly.\n\nExample:\n```\nrollbar-cli upload-sourcemaps ./dist --access-token 638d... --url-prefix 'http://example.com/' --code-version 123.456\n```\nor\n```\nrollbar-cli upload-sourcemaps ./dist --access-token 638d... --url-prefix 'http://example.com/' --code-version 123.456 --next\n```\n\n### notify-deploy\nNotify deploy to Rollbar.\n\n```\nrollbar-cli notify-deploy [options]\n\nNotify deploy to Rollbar\n\nOptions:\n  --version           Show version number                              [boolean]\n  -v, --verbose       Verbose status output                            [boolean]\n  -q, --quiet         Silent status output                             [boolean]\n  --help              Show help                                        [boolean]\n  --access-token      Use a post server item access token for the Rollbar API\n                                                             [string] [required]\n  --code-version      Code version or Git SHA of revision being deployed\n                                                             [string] [required]\n  --deploy-id         ID of the deploy to update                        [string]\n  --environment       Environment to which the revision was deployed such as\n                      production                             [string] [required]\n  --status            Status of the deploy - started, succeeded (default),\n                      failed, or timed_out                              [string]\n  --rollbar-username  Rollbar username of person who deployed           [string]\n  --local-username    Local username of person who deployed             [string]\n  --comment           Additional text to include with the deploy        [string]\n```\n\nExample:\n```\nrollbar-cli notify-deploy --access-token 1234 --code-version 1.0.1 --environment production --rollbar-username foobar --status succeeded --local-username foo_bar --comment 'Deploy Test'\n```\n\nOutput on success:\n```\n         { deploy_id: 12345678 }\n         Deploy successful\n```\n\n## Release History \u0026 Changelog\n\nSee our [Releases](https://github.com/rollbar/rollbar-cli/releases) page for a list of all releases, including changes.\n\n## Help / Support\n\nIf you run into any issues, please email us at [support@rollbar.com](mailto:support@rollbar.com).\n\nFor bug reports, please [open an issue on GitHub](https://github.com/rollbar/rollbar-cli/issues/new).\n\n## Developing\n\nTo set up a development environment, you'll need Node.js and npm.\n\n1. Install dependencies\n`npm install`\n\n2. Link the rollbar-cli command to the local repo\n`npm link`\n\n3. Run the tests\n`npm test`\n\n## Contributing\n\n1. [Fork it](https://github.com/rollbar/rollbar-cli).\n2. Create your feature branch (`git checkout -b my-new-feature`).\n3. Commit your changes (`git commit -am 'Added some feature'`).\n4. Push to the branch (`git push origin my-new-feature`).\n5. Create a new Pull Request.\n\n## License\n\nrollbar-cli is free software released under the MIT License. See LICENSE for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frollbar%2Frollbar-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frollbar%2Frollbar-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frollbar%2Frollbar-cli/lists"}