https://github.com/heroku/heroku-slugs
CLI Plugin to manage downloading of slugs
https://github.com/heroku/heroku-slugs
heroku heroku-cli-plugin
Last synced: 5 months ago
JSON representation
CLI Plugin to manage downloading of slugs
- Host: GitHub
- URL: https://github.com/heroku/heroku-slugs
- Owner: heroku
- License: isc
- Created: 2017-02-06T15:56:12.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2025-05-18T19:40:30.000Z (about 1 year ago)
- Last Synced: 2025-05-19T13:25:48.334Z (about 1 year ago)
- Topics: heroku, heroku-cli-plugin
- Language: TypeScript
- Size: 296 KB
- Stars: 37
- Watchers: 87
- Forks: 10
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Heroku Slugs CLI Plugin
This plugin adds commands to the Heroku CLI for downloading slugs
## Commands
```
$ heroku slugs -a appname
Slugs in appname
v24: 00000000-bbbb-cccc-dddd-eeeeeeeeeeee
v23: 11111111-bbbb-cccc-dddd-eeeeeeeeeeee
v22: 22222222-bbbb-cccc-dddd-eeeeeeeeeeee
v21: 33333333-bbbb-cccc-dddd-eeeeeeeeeeee
$ heroku slugs:download 00000000-bbbb-cccc-dddd-eeeeeeeeeeee -a appname
```
This will download the Slug directly from our filestore on S3
## Using a proxy
```
$ export HEROKU_HTTP_PROXY_HOST=
$ export HEROKU_HTTP_PROXY_PORT=
$ heroku slugs:download 00000000-bbbb-cccc-dddd-eeeeeeeeeeee -a appname
```
* [Heroku Slugs CLI Plugin](#heroku-slugs-cli-plugin)
* [Usage](#usage)
* [Commands](#commands)
# Usage
```sh-session
$ heroku plugins:install @heroku-cli/heroku-slugs
$ heroku COMMAND
running command...
...
```
# Commands
* [`heroku slugs`](#heroku-slugs)
* [`heroku slugs:download [SLUG]`](#heroku-slugsdownload-slug)
## `heroku slugs`
list recent slugs on application
```
USAGE
$ heroku slugs -a [-r ]
FLAGS
-a, --app= (required) app to run command against
-r, --remote= git remote of app to use
DESCRIPTION
list recent slugs on application
EXAMPLES
$ heroku slugs --app myapp
```
_See code: [src/commands/slugs/index.ts](https://github.com/heroku/heroku-slugs/blob/v2.0.0/src/commands/slugs/index.ts)_
## `heroku slugs:download [SLUG]`
download a slug's tarball to /slug.tar.gz and then extract the slug
```
USAGE
$ heroku slugs:download [SLUG] -a [-e] [-r ]
ARGUMENTS
SLUG name or ID of slug
FLAGS
-a, --app= (required) app to run command against
-e, --no-extract-slug skip extracting slug after download
-r, --remote= git remote of app to use
DESCRIPTION
download a slug's tarball to /slug.tar.gz and then extract the slug
EXAMPLES
$ heroku slugs:download --app example-app v2
$ heroku slugs:download --app example-app v2 --no-extract-slug
```
_See code: [src/commands/slugs/download.ts](https://github.com/heroku/heroku-slugs/blob/v2.0.0/src/commands/slugs/download.ts)_