{"id":50610288,"url":"https://github.com/jeffersongoncalves/jira-cli","last_synced_at":"2026-06-06T03:01:59.123Z","repository":{"id":340265182,"uuid":"1165242710","full_name":"jeffersongoncalves/jira-cli","owner":"jeffersongoncalves","description":"Modern Jira Cloud CLI. Manage issues, epics, sprints, boards, and more from your terminal. Built with Laravel Zero.","archived":false,"fork":false,"pushed_at":"2026-04-16T19:28:59.000Z","size":27986,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-16T21:27:59.617Z","etag":null,"topics":["atlassian","cli","command-line","console","devtools","jira","jira-api","jira-cli","jira-cloud","laravel-zero","phar","php","productivity"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":false,"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/jeffersongoncalves.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","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},"funding":{"github":"jeffersongoncalves"}},"created_at":"2026-02-24T00:58:54.000Z","updated_at":"2026-04-16T19:29:05.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jeffersongoncalves/jira-cli","commit_stats":null,"previous_names":["jeffersongoncalves/jira-cli"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/jeffersongoncalves/jira-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeffersongoncalves%2Fjira-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeffersongoncalves%2Fjira-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeffersongoncalves%2Fjira-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeffersongoncalves%2Fjira-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jeffersongoncalves","download_url":"https://codeload.github.com/jeffersongoncalves/jira-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeffersongoncalves%2Fjira-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33967641,"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-06T02:00:07.033Z","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":["atlassian","cli","command-line","console","devtools","jira","jira-api","jira-cli","jira-cloud","laravel-zero","phar","php","productivity"],"created_at":"2026-06-06T03:01:58.602Z","updated_at":"2026-06-06T03:01:59.116Z","avatar_url":"https://github.com/jeffersongoncalves.png","language":"PHP","funding_links":["https://github.com/sponsors/jeffersongoncalves"],"categories":[],"sub_categories":[],"readme":"\u003cdiv class=\"filament-hidden\"\u003e\n\n![Jira CLI](https://raw.githubusercontent.com/jeffersongoncalves/jira-cli/main/art/jeffersongoncalves-jira-cli.png)\n\n\u003c/div\u003e\n\n# Jira CLI\n\nA modern Jira Cloud CLI built with [Laravel Zero](https://laravel-zero.com/).\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/jeffersongoncalves/jira-cli/actions\"\u003e\u003cimg src=\"https://github.com/jeffersongoncalves/jira-cli/actions/workflows/run-tests.yml/badge.svg\" alt=\"Tests\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/jeffersongoncalves/jira-cli/actions\"\u003e\u003cimg src=\"https://github.com/jeffersongoncalves/jira-cli/actions/workflows/build.yml/badge.svg\" alt=\"Build\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://packagist.org/packages/jeffersongoncalves/jira-cli\"\u003e\u003cimg src=\"https://img.shields.io/packagist/dt/jeffersongoncalves/jira-cli\" alt=\"Total Downloads\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/jeffersongoncalves/jira-cli/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/jeffersongoncalves/jira-cli\" alt=\"License\" /\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/php-%3E%3D8.2-8892BF\" alt=\"PHP 8.2+\" /\u003e\n\u003c/p\u003e\n\n## Features\n\n- **Issues** - Create, list, view, edit, move, assign, delete, comment, worklog, link, clone, and watch issues\n- **Epics** - List, create, and manage epic associations\n- **Sprints** - List, add issues, and close sprints\n- **Boards** - List boards with project filtering\n- **Projects** - List accessible projects\n- **Releases** - List project versions and releases\n- **Authentication** - Secure credential storage with API tokens (Basic and Bearer)\n- **Browse** - Open issues and projects in the browser from the terminal\n\n## Requirements\n\n- PHP 8.2+\n\n## Installation\n\n```bash\ncomposer global require jeffersongoncalves/jira-cli\n```\n\nOr clone and build locally:\n\n```bash\ngit clone https://github.com/jeffersongoncalves/jira-cli.git\ncd jira-cli\ncomposer install\nphp jira app:build jira\n```\n\n## Getting Started\n\n### 1. Create a Jira API Token\n\n1. Go to [https://id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens)\n2. Click **Create API token**\n3. Give it a descriptive label (e.g. `jira-cli`)\n4. Click **Create** and **copy it immediately** - it will only be shown once\n\nThe API token inherits all permissions from your Atlassian account. For OAuth 2.0 / Forge apps, the following granular scopes are required:\n\n\u003e **Note:** API tokens (Basic auth) inherit all permissions from the account - no scope configuration needed. Scopes below are only for OAuth 2.0 and Forge integrations.\n\n**Jira Platform Scopes:**\n\n| Scope | Permission | Required for |\n|-------|-----------|-------------|\n| `read:issue:jira` | Read | List, view, and clone issues |\n| `write:issue:jira` | Write | Create, edit, assign, and clone issues |\n| `delete:issue:jira` | Delete | Delete issues |\n| `read:issue.transition:jira` | Read | List available status transitions |\n| `read:comment:jira` | Read | View issue comments |\n| `write:comment:jira` | Write | Add comments to issues |\n| `read:issue-worklog:jira` | Read | List worklogs |\n| `write:issue-worklog:jira` | Write | Log time on issues |\n| `read:issue-link:jira` | Read | View linked issues |\n| `write:issue-link:jira` | Write | Link issues together |\n| `delete:issue-link:jira` | Delete | Remove issue links |\n| `read:issue-link-type:jira` | Read | List link types |\n| `write:issue.watcher:jira` | Write | Watch issues |\n| `read:project:jira` | Read | List projects |\n| `read:project-version:jira` | Read | List releases/versions |\n| `read:user:jira` | Read | User info and assignment |\n\n**Jira Software (Agile) Scopes:**\n\n| Scope | Permission | Required for |\n|-------|-----------|-------------|\n| `read:board-scope:jira-software` | Read | List boards |\n| `read:sprint:jira-software` | Read | List sprints |\n| `write:sprint:jira-software` | Write | Add issues to sprint, close sprint |\n| `read:epic:jira-software` | Read | List epics |\n| `write:epic:jira-software` | Write | Add/remove issues from epics |\n\n### 2. Save your credentials\n\n```bash\njira auth:save\n```\n\nYou will be prompted for your Jira server URL, Atlassian account email, and API token.\n\n### 3. Verify authentication\n\n```bash\njira auth:show\n```\n\n### 4. Start using commands\n\n```bash\njira issue:list --project=PROJ\njira issue:view PROJ-123\njira me\n```\n\n## Commands\n\n### Authentication\n\n| Command | Description |\n|---------|-------------|\n| `auth:save` | Save Jira credentials (server, email, API token) |\n| `auth:show` | Display saved credentials |\n\n### Issues\n\n| Command | Description |\n|---------|-------------|\n| `issue:list` | List/search issues with JQL filters (`--project`, `--type`, `--status`, `--assignee`) |\n| `issue:view \u003ckey\u003e` | View issue details (`--comments` to include comments) |\n| `issue:create` | Create a new issue (interactive or via options) |\n| `issue:edit \u003ckey\u003e` | Edit issue fields (`--summary`, `--priority`, `--assignee`) |\n| `issue:move \u003ckey\u003e` | Transition issue status (`--status` or interactive) |\n| `issue:assign \u003ckey\u003e [user]` | Assign issue (`me` for yourself, empty to unassign) |\n| `issue:delete \u003ckey\u003e` | Delete an issue (`--force` to skip confirmation) |\n| `issue:comment \u003ckey\u003e` | Add a comment (`--body` or interactive) |\n| `issue:worklog \u003ckey\u003e` | Log time (`--time=2h`) or list worklogs (`--list`) |\n| `issue:link \u003cinward\u003e \u003coutward\u003e` | Link two issues (`--type` or interactive) |\n| `issue:unlink \u003clinkId\u003e` | Remove an issue link |\n| `issue:clone \u003ckey\u003e` | Duplicate an issue |\n| `issue:watch \u003ckey\u003e` | Watch an issue |\n\n### Epics\n\n| Command | Description |\n|---------|-------------|\n| `epic:list` | List epics (`--project=KEY`) |\n| `epic:create` | Create a new epic (interactive or via options) |\n| `epic:add \u003cepic\u003e \u003cissues...\u003e` | Add issues to an epic |\n| `epic:remove \u003cissues...\u003e` | Remove issues from their epic |\n\n### Sprints\n\n| Command | Description |\n|---------|-------------|\n| `sprint:list` | List sprints (`--board=ID`, `--state=active\\|closed\\|future`) |\n| `sprint:add \u003csprint\u003e \u003cissues...\u003e` | Add issues to a sprint |\n| `sprint:close \u003csprint\u003e` | Close/complete a sprint (`--force` to skip confirmation) |\n\n### Boards, Projects \u0026 Releases\n\n| Command | Description |\n|---------|-------------|\n| `board:list` | List boards (`--project` to filter) |\n| `project:list` | List accessible projects |\n| `release:list` | List project versions (`--project=KEY`) |\n\n### Utilities\n\n| Command | Description |\n|---------|-------------|\n| `me` | Show current authenticated user |\n| `open [key]` | Open issue or project in the browser |\n| `serverinfo` | Show Jira server information |\n\n## Development\n\n```bash\n# Install dependencies\ncomposer install\n\n# Run tests\ncomposer test\n\n# Run tests only\ncomposer test:unit\n\n# Code formatting\n./vendor/bin/pint\n\n# Static analysis\ncomposer test:types\n```\n\n## Changelog\n\nPlease see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.\n\n## License\n\nJira CLI is open-source software licensed under the [MIT license](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeffersongoncalves%2Fjira-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjeffersongoncalves%2Fjira-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeffersongoncalves%2Fjira-cli/lists"}