{"action":"created","issue":{"url":"https://api.github.com/repos/buildkite/agent/issues/109","labels_url":"https://api.github.com/repos/buildkite/agent/issues/109/labels{/name}","comments_url":"https://api.github.com/repos/buildkite/agent/issues/109/comments","events_url":"https://api.github.com/repos/buildkite/agent/issues/109/events","html_url":"https://github.com/buildkite/agent/issues/109","id":62594515,"number":109,"title":"Artifact --help","user":{"login":"toolmantim","id":153,"avatar_url":"https://avatars.githubusercontent.com/u/153?v=3","gravatar_id":"","url":"https://api.github.com/users/toolmantim","html_url":"https://github.com/toolmantim","followers_url":"https://api.github.com/users/toolmantim/followers","following_url":"https://api.github.com/users/toolmantim/following{/other_user}","gists_url":"https://api.github.com/users/toolmantim/gists{/gist_id}","starred_url":"https://api.github.com/users/toolmantim/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/toolmantim/subscriptions","organizations_url":"https://api.github.com/users/toolmantim/orgs","repos_url":"https://api.github.com/users/toolmantim/repos","events_url":"https://api.github.com/users/toolmantim/events{/privacy}","received_events_url":"https://api.github.com/users/toolmantim/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-03-18T05:33:25Z","updated_at":"2015-03-19T18:53:46Z","closed_at":null,"body":"Running `buildkite-agent artifact --help` just shows download help, but doesn't show the various sub-commands.\r\n\r\nI tried `buildkite-agent --help` but that doesn't show it either.\r\n\r\n```\r\n$ buildkite-agent artifact --help\r\nUsage:\r\n\r\n   buildkite-agent artifact download [arguments...]\r\n\r\nDescription:\r\n\r\n   Downloads artifacts from Buildkite to the local machine.\r\n\r\n   Note: You need to ensure that your search query is surrounded by quotes if\r\n   using a wild card as the built-in shell path globbing will provide files,\r\n   which will break the download.\r\n\r\nExample:\r\n\r\n   $ buildkite-agent artifact download \"pkg/*.tar.gz\" . --build xxx\r\n\r\n   This will search across all the artifacts for the build with files that match that part.\r\n   The first argument is the search query, and the second argument is the download destination.\r\n\r\n   If you're trying to download a specific file, and there are multiple artifacts from different\r\n   jobs, you can target the paticular job you want to download the artifact from:\r\n\r\n   $ buildkite-agent artifact download \"pkg/*.tar.gz\" . --job \"tests\" --build xxx\r\n\r\n   You can also use the job's id (provided by the environment variable $BUILDKITE_JOB_ID)\r\n\r\nOptions:\r\n\r\n   --job \t\t\t\t\tUsed to target a specific job to download artifacts from\r\n   --build \t\t\t\t\tWhich build should the artifacts be downloaded from [$BUILDKITE_BUILD_ID]\r\n   --agent-access-token \t\t\tThe access token used to identify the agent [$BUILDKITE_AGENT_ACCESS_TOKEN]\r\n   --endpoint \"https://agent.buildkite.com/v2\"\tThe agent API endpoint [$BUILDKITE_AGENT_ENDPOINT]\r\n   --debug\t\t\t\t\tEnable debug mode [$BUILDKITE_AGENT_DEBUG]\r\n   --no-color\t\t\t\t\tDon't show colors in logging [$BUILDKITE_AGENT_NO_COLOR]\r\n   \r\n```"},"comment":{"url":"https://api.github.com/repos/buildkite/agent/issues/comments/83716451","html_url":"https://github.com/buildkite/agent/issues/109#issuecomment-83716451","issue_url":"https://api.github.com/repos/buildkite/agent/issues/109","id":83716451,"user":{"login":"keithpitt","id":25882,"avatar_url":"https://avatars.githubusercontent.com/u/25882?v=3","gravatar_id":"","url":"https://api.github.com/users/keithpitt","html_url":"https://github.com/keithpitt","followers_url":"https://api.github.com/users/keithpitt/followers","following_url":"https://api.github.com/users/keithpitt/following{/other_user}","gists_url":"https://api.github.com/users/keithpitt/gists{/gist_id}","starred_url":"https://api.github.com/users/keithpitt/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/keithpitt/subscriptions","organizations_url":"https://api.github.com/users/keithpitt/orgs","repos_url":"https://api.github.com/users/keithpitt/repos","events_url":"https://api.github.com/users/keithpitt/events{/privacy}","received_events_url":"https://api.github.com/users/keithpitt/received_events","type":"User","site_admin":false},"created_at":"2015-03-19T18:53:46Z","updated_at":"2015-03-19T18:53:46Z","body":"```\r\n❯ buildkite-agent --help                                                                                                                                                                  agent/git/master\r\nUsage:\r\n\r\n  buildkite-agent <command> [arguments...]\r\n\r\nAvailable comamnds are:\r\n\r\n  start\t\tStarts a Buildkite agent\r\n  artifact\tUpload/download artifacts from Buildkite jobs\r\n  meta-data\tGet/set data from Buildkite jobs\r\n  help, h\tShows a list of commands or help for one command\r\n\r\nUse \"buildkite-agent <command> --help\" for more information about a command.\r\n```\r\n\r\n```\r\n❯ buildkite-agent artifact --help                                                                                                                                                         agent/git/master\r\nUsage:\r\n\r\n  buildkite-agent artifact <command> [arguments...]\r\n\r\nAvailable comamnds are:\r\n\r\n   download\tDownloads artifacts from Buildkite to the local machine\r\n   upload\tUploads files to a job as artifacts\r\n   shasum\tPrints the SHA-1 checksum for the artifact provided to STDOUT\r\n   help, h\tShows a list of commands or help for one command\r\n\r\nOptions:\r\n\r\n   --help, -h\tshow help\r\n```\r\n\r\n```\r\n❯ buildkite-agent artifact download --help                                                                                                                                                agent/git/master\r\nUsage:\r\n\r\n   buildkite-agent artifact download [arguments...]\r\n\r\nDescription:\r\n\r\n   Downloads artifacts from Buildkite to the local machine.\r\n\r\n   Note: You need to ensure that your search query is surrounded by quotes if\r\n   using a wild card as the built-in shell path globbing will provide files,\r\n   which will break the download.\r\n\r\nExample:\r\n\r\n   $ buildkite-agent artifact download \"pkg/*.tar.gz\" . --build xxx\r\n\r\n   This will search across all the artifacts for the build with files that match that part.\r\n   The first argument is the search query, and the second argument is the download destination.\r\n...\r\n```"}}