{"id":50991753,"url":"https://github.com/buddy/artifact-download","last_synced_at":"2026-06-20T04:05:33.523Z","repository":{"id":337379998,"uuid":"1130243083","full_name":"buddy/artifact-download","owner":"buddy","description":null,"archived":false,"fork":false,"pushed_at":"2026-06-11T13:14:43.000Z","size":369,"stargazers_count":16,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-11T15:08:34.780Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"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/buddy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":null,"dco":null,"cla":null}},"created_at":"2026-01-08T08:26:21.000Z","updated_at":"2026-06-11T13:17:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/buddy/artifact-download","commit_stats":null,"previous_names":["buddy/pkg-download","buddy/artifact-download"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/buddy/artifact-download","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buddy%2Fartifact-download","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buddy%2Fartifact-download/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buddy%2Fartifact-download/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buddy%2Fartifact-download/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/buddy","download_url":"https://codeload.github.com/buddy/artifact-download/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buddy%2Fartifact-download/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34556500,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-20T02:00:06.407Z","response_time":98,"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":"2026-06-20T04:05:32.900Z","updated_at":"2026-06-20T04:05:33.519Z","avatar_url":"https://github.com/buddy.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Buddy Download Artifact GitHub Action\n\nDownload artifacts from Buddy CI/CD platform in GitHub Actions workflows.\n\n## Features\n\n- Download artifacts directly in GitHub Actions\n- Support for versioned artifacts (artifact@version)\n- Merge or replace directory contents\n\n## Usage\n\n### Basic Usage\n\n```yaml\nname: Download\non: [push]\n\njobs:\n  download:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n\n      - name: Login to Buddy\n        uses: buddy/login@v1\n        with:\n          token: ${{ secrets.BUDDY_TOKEN }}\n          region: 'US'\n\n      - name: Download artifact\n        uses: buddy/artifact-download@v1\n        with:\n          workspace: my-workspace\n          project: my-project\n          identifier: my-artifact\n          directory: ./artifacts\n```\n\n### Download Specific Version\n\n```yaml\n- name: Download versioned artifact\n  uses: buddy/artifact-download@v1\n  with:\n    workspace: my-workspace\n    project: my-project\n    identifier: my-artifact@1.0.0\n    directory: ./artifacts\n```\n\n### Merge With Existing Directory\n\n```yaml\n- name: Download and merge\n  uses: buddy/artifact-download@v1\n  with:\n    workspace: my-workspace\n    project: my-project\n    identifier: my-artifact\n    directory: ./artifacts\n    merge: true\n```\n\n### Replace Directory Contents\n\n```yaml\n- name: Download and replace\n  uses: buddy/artifact-download@v1\n  with:\n    workspace: my-workspace\n    project: my-project\n    identifier: my-artifact\n    directory: ./artifacts\n    replace: true\n```\n\n## Inputs\n\n| Input        | Required | Description                                                           |\n| ------------ | -------- | --------------------------------------------------------------------- |\n| `workspace`  | Yes      | Buddy workspace domain                                                |\n| `project`    | Yes      | Buddy project name (URL handle)                                       |\n| `identifier` | Yes      | Artifact identifier with optional version (e.g., `my-artifact@1.0.0`) |\n| `directory`  | Yes      | Path to the directory to download to                                  |\n| `merge`      | No       | Merge contents of the directory with artifact (`true`/`false`)        |\n| `replace`    | No       | Replace contents of the directory with artifact (`true`/`false`)      |\n| `debug`      | No       | Run the BDY CLI in DEBUG mode and dump `~/.bdy/cli.log` on failure    |\n\n## Outputs\n\n| Output          | Description                                |\n| --------------- | ------------------------------------------ |\n| `artifact_path` | The path where the artifact was downloaded |\n\n## Environment Variables\n\nThe action exports the following environment variables for use in subsequent steps:\n\n| Variable              | Description                                |\n| --------------------- | ------------------------------------------ |\n| `BUDDY_ARTIFACT_PATH` | The path where the artifact was downloaded |\n\n## Prerequisites\n\nThis action requires authentication with Buddy. Use the [`buddy/login`](https://github.com/buddy/login) action before downloading artifacts:\n\n```yaml\n- name: Login to Buddy\n  uses: buddy/login@v1\n  with:\n    token: ${{ secrets.BUDDY_TOKEN }}\n    region: 'US'\n```\n\nThe login action sets the following environment variables that are used by this action:\n\n- `BUDDY_TOKEN` - Authentication token\n- `BUDDY_API_ENDPOINT` - API endpoint URL\n\n### BDY CLI Installation\n\nBy default, this action automatically installs the latest BDY CLI from the production channel. If you need a specific version or channel, use the `buddy/setup` action first:\n\n```yaml\n- name: Setup BDY CLI\n  uses: buddy/setup@v1\n  with:\n    version: '1.12.8'\n```\n\nSee the [`buddy/setup`](https://github.com/buddy/setup) action for more options.\n\n## Debugging\n\nIf a BDY CLI command fails, the action throws an error that includes the exit code, the command that was run, and its captured output.\n\nEnabling debug runs the BDY CLI in DEBUG mode, so it writes verbose logs to `~/.bdy/cli.log`, and on failure dumps that log (plus a stack trace) into the workflow output. Enable it in either of these ways:\n\n- **Per step** — set the `debug` input on this action:\n\n  ```yaml\n  - uses: buddy/artifact-download@v1\n    with:\n      # ...\n      debug: true\n  ```\n\n- **Whole run** — enable [GitHub step debug logging](https://docs.github.com/en/actions/monitoring-and-troubleshooting-workflows/enabling-debug-logging), either by ticking **Enable debug logging** in the \"Re-run jobs\" dialog or by setting the `ACTIONS_STEP_DEBUG` repository secret/variable to `true`.\n\n## License\n\nMIT - See [LICENSE.md](LICENSE.md) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbuddy%2Fartifact-download","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbuddy%2Fartifact-download","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbuddy%2Fartifact-download/lists"}