{"id":50337300,"url":"https://github.com/go-tapd/cli","last_synced_at":"2026-05-29T14:30:36.129Z","repository":{"id":358921251,"uuid":"1192765958","full_name":"go-tapd/cli","owner":"go-tapd","description":"A Go command line client for TAPD, built on the typed go-tapd SDK. Supports stories, bugs, tasks, workspaces, wiki, tests, releases, webhooks, and more.","archived":false,"fork":false,"pushed_at":"2026-05-28T01:29:23.000Z","size":1529,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-28T03:17:06.238Z","etag":null,"topics":["ai","cli","command-line","tapd","tools"],"latest_commit_sha":null,"homepage":"https://github.com/go-tapd/cli","language":"Go","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/go-tapd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-26T14:40:51.000Z","updated_at":"2026-05-28T01:29:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/go-tapd/cli","commit_stats":null,"previous_names":["go-tapd/cli"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/go-tapd/cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/go-tapd%2Fcli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/go-tapd%2Fcli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/go-tapd%2Fcli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/go-tapd%2Fcli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/go-tapd","download_url":"https://codeload.github.com/go-tapd/cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/go-tapd%2Fcli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33657690,"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-05-29T02:00:06.066Z","response_time":107,"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":["ai","cli","command-line","tapd","tools"],"created_at":"2026-05-29T14:30:35.497Z","updated_at":"2026-05-29T14:30:36.116Z","avatar_url":"https://github.com/go-tapd.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"internal/arts/logo.png\" alt=\"TAPD CLI logo\" width=\"220\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eTAPD CLI\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/go-tapd/cli/actions/workflows/lint.yml\"\u003e\u003cimg alt=\"Lint\" src=\"https://github.com/go-tapd/cli/actions/workflows/lint.yml/badge.svg\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://pkg.go.dev/github.com/go-tapd/cli\"\u003e\u003cimg alt=\"Go Reference\" src=\"https://pkg.go.dev/badge/github.com/go-tapd/cli.svg\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/go-tapd/cli/blob/main/LICENSE\"\u003e\u003cimg alt=\"License: MIT\" src=\"https://img.shields.io/badge/License-MIT-blue.svg\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/go-tapd/cli\"\u003e\u003cimg alt=\"Go Version\" src=\"https://img.shields.io/badge/Go-%3E%3D%201.25-00ADD8.svg\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n`tapd` is a command line client for TAPD, built on top of the typed\n[`github.com/go-tapd/tapd`](https://github.com/go-tapd/tapd) SDK.\n\nIt provides commands for common TAPD resources such as stories, bugs, tasks,\niterations, workspaces, wiki pages, test cases, releases, comments, attachments,\nwebhooks, and TAPD Lite comments.\n\n## 📦 Install\n\n### Homebrew\n\n```bash\nbrew install go-tapd/tap/tapd\n```\n\n### npm\n\nUse this when you want to install `tapd` through Node.js tooling:\n\n```bash\nnpm install -g @go-tapd/tapd\n```\n\n### GitHub Releases\n\nDownload a prebuilt archive for your platform from\n[GitHub Releases](https://github.com/go-tapd/cli/releases).\n\n### Go\n\n```bash\ngo install github.com/go-tapd/cli/cmd/tapd@latest\n```\n\nRequires Go 1.25 or later. This installs a binary named `tapd`.\n\n## 🚀 Quick Start\n\n```bash\ntapd login --auth-method pat\ntapd auth status\ntapd story list --workspace-id 123456 --limit 20\n```\n\nUse `tapd --help` and `tapd \u003ccommand\u003e --help` to inspect available commands and\nflags.\n\n## 🔐 Authentication\n\nThe recommended interactive setup is `tapd login`.\n\nPersonal access token:\n\n```bash\ntapd login --auth-method pat\n```\n\nValidate credentials during login:\n\n```bash\ntapd login --auth-method pat --workspace-id 123456\n```\n\nBasic authentication:\n\n```bash\ntapd login --auth-method basic\n```\n\nYou can also pass credentials directly:\n\n```bash\ntapd login --token \"$TAPD_ACCESS_TOKEN\"\ntapd login --client-id \"$TAPD_CLIENT_ID\" --client-secret \"$TAPD_CLIENT_SECRET\"\n```\n\nThe login command stores credentials in:\n\n```text\n~/.tapd/config.json\n```\n\nFor CI or temporary shell sessions, you can skip local config and use\nenvironment variables:\n\n```bash\nexport TAPD_ACCESS_TOKEN=...\n```\n\nor:\n\n```bash\nexport TAPD_CLIENT_ID=...\nexport TAPD_CLIENT_SECRET=...\n```\n\n## ✨ Common Examples\n\n```bash\ntapd workspace view --workspace-id 123456\ntapd workspace users --workspace-id 123456\n\ntapd story list --workspace-id 123456 --limit 20\ntapd story view 1111112222001000001 --workspace-id 123456\ntapd story create --workspace-id 123456 --name \"New story\" --owner alice\n\ntapd bug list --workspace-id 123456 --owner alice\ntapd bug create --workspace-id 123456 --title \"Login fails\" --owner alice\n\ntapd task list --workspace-id 123456 --creator bob --format json\ntapd webhook inspect --file payload.json\ntapd webhook serve --addr 127.0.0.1:8080 --path /webhook\n```\n\n## 🧭 Command Areas\n\n- Authentication: `tapd login`, `tapd auth status`, `tapd auth logout`\n- Workspaces: `tapd workspace ...`\n- Stories: `tapd story ...`\n- Bugs: `tapd bug ...`\n- Tasks: `tapd task ...`\n- Iterations: `tapd iteration ...`\n- Tests: `tapd test-case ...`, `tapd test-plan ...`\n- Releases: `tapd release ...`, `tapd launch-form ...`\n- Wiki: `tapd wiki ...`\n- Reports and metrics: `tapd report ...`, `tapd measure ...`\n- Timesheets: `tapd timesheet ...`\n- Comments: `tapd comment ...`\n- Attachments: `tapd attachment ...`\n- Boards: `tapd board ...`\n- Workflow and settings: `tapd workflow ...`, `tapd setting ...`\n- Labels and users: `tapd label ...`, `tapd user ...`\n- Source integrations: `tapd source ...`\n- Webhooks: `tapd webhook ...`\n- TAPD Lite: `tapd lite comment ...`\n\n## 📚 Documentation\n\n- [Shell completion](docs/shell-completion.md)\n- [Workspace commands](docs/workspace.md)\n- [Story commands](docs/story.md)\n- [Bug commands](docs/bug.md)\n- [Task commands](docs/task.md)\n- [Iteration commands](docs/iteration.md)\n- [Test commands](docs/test.md)\n- [Release commands](docs/release.md)\n- [Wiki commands](docs/wiki.md)\n- [Report commands](docs/report.md)\n- [Attachment commands](docs/attachment.md)\n- [Measure commands](docs/measure.md)\n- [Timesheet commands](docs/timesheet.md)\n- [Comment commands](docs/comment.md)\n- [Board commands](docs/board.md)\n- [Workflow commands](docs/workflow.md)\n- [Setting commands](docs/setting.md)\n- [Label commands](docs/label.md)\n- [User commands](docs/user.md)\n- [Source commands](docs/source.md)\n- [Webhook commands](docs/webhook.md)\n- [Lite commands](docs/lite.md)\n- [Feature coverage](features.md)\n\n## 🛠️ Development\n\n```bash\nmake lint\nmake test\ngo build ./...\n```\n\nTest coverage is currently minimal, so command and documentation changes should\nalso be checked with the relevant `tapd \u003ccommand\u003e --help` output.\n\nWhen adding a command, prefer the typed services, requests, and responses from\n`github.com/go-tapd/tapd` rather than writing ad hoc HTTP calls.\n\n## 📄 License\n\nThis project is licensed under the [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgo-tapd%2Fcli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgo-tapd%2Fcli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgo-tapd%2Fcli/lists"}