Atlassian Cloud (Jira / Bitbucket) 向け CLI ツール。
Jira の課題管理や Bitbucket のリポジトリ・PR 操作をターミナルから実行できます。--json フラグによる機械可読出力に対応しており、AI エディタ(Claude Code / Codex / Cursor)向けのスキル定義も同梱しています。
Jira Cloud
- 課題の作成・閲覧・更新・検索(JQL)
- スプリント一覧・スプリント内課題の表示
- ユーザー検索・課題へのアサイン
- コメントの追加
Bitbucket Cloud
- リポジトリ一覧・詳細の取得
- プルリクエストの作成・コメント取得
その他
-
--jsonフラグで全コマンドの出力を JSON 形式に変換 - AI エディタ向けスキル定義の同梱と
install-skillsコマンドによる展開
go install github.com/novshi-tech/atl-cli/cmd/atl@latestatl configure --site mysite --default対話形式で以下のフィールドを入力します(既存値がある場合は Enter でスキップ可能)。
| フィールド | 説明 |
|---|---|
| Site URL | Atlassian サイトの URL(例: https://myteam.atlassian.net) |
| Atlassian アカウントのメールアドレス | |
| API Token | Jira 用 API トークン |
| Bitbucket API Token | Bitbucket 用 API トークン(省略可) |
どちらも同じ Atlassian アカウント管理ページからトークンを発行します:
https://id.atlassian.com/manage-profile/security/api-tokens
- Jira 用トークン: 上記ページで発行したトークンをそのまま使用します。
- Bitbucket 用トークン: 同じページでトークンを発行しますが、Bitbucket 専用のスコープ(Repositories: Read/Write 等)を付与した別トークンを作成してください。Jira 用トークンとは別に発行する必要があります。
認証情報は OS のキーリング(macOS Keychain / GNOME Keyring 等)に保存されます。キーリングが利用できない環境では pass(1) にフォールバックします。
設定済みサイトの一覧を確認:
atl sitesコマンド実行時に --site フラグでサイトを切り替えられます:
atl jira issue list --site other-site --jql "project = DEMO"AI エディタ向けのスキル定義をローカルに展開します:
atl install-skills| オプション | 説明 |
|---|---|
--list |
利用可能なスキルの一覧を表示 |
--dry-run |
書き込みせずにプレビュー |
--path <dir> |
展開先ディレクトリを指定 |
# JQL で課題を検索
atl jira issue list --jql "project = MYPROJ AND status = 'In Progress'"
# 課題の詳細を表示
atl jira issue view --key MYPROJ-123
# 課題を作成
atl jira issue create -p MYPROJ -s "バグ修正" -t Bug -d "ログイン画面のエラーを修正"
# 課題を更新
atl jira issue update --key MYPROJ-123 --status Done --assignee none
# コメントを追加
atl jira issue comment --key MYPROJ-123 -b "対応完了しました"
# スプリント一覧
atl jira sprint list --board 1 --state active
# スプリント内の課題
atl jira sprint issues --sprint 10
# ユーザー検索
atl jira user search -q "tanaka"# リポジトリ一覧
atl bitbucket repo list --workspace myws
# リポジトリ詳細
atl bitbucket repo get --workspace myws --repo myrepo
# プルリクエスト作成
atl bitbucket pr create --workspace myws --repo myrepo --title "機能追加" --source feature-branch
# PR のコメント取得
atl bitbucket pr comment --workspace myws --repo myrepo --pr 42全コマンドで --json フラグが使用可能です:
atl jira issue list --jql "project = MYPROJ" --jsonMIT License — 詳細は LICENSE を参照。