atlcli

README

atl

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@latest

初期セットアップ

1. サイトの設定

atl configure --site mysite --default

対話形式で以下のフィールドを入力します（既存値がある場合は Enter でスキップ可能）。

フィールド	説明
Site URL	Atlassian サイトの URL（例: https://myteam.atlassian.net）
Email	Atlassian アカウントのメールアドレス
API Token	Jira 用 API トークン
Bitbucket API Token	Bitbucket 用 API トークン（省略可）

2. API トークンの取得

どちらも同じ Atlassian アカウント管理ページからトークンを発行します:

https://id.atlassian.com/manage-profile/security/api-tokens

• Jira 用トークン: 上記ページで発行したトークンをそのまま使用します。
• Bitbucket 用トークン: 同じページでトークンを発行しますが、Bitbucket 専用のスコープ（Repositories: Read/Write 等）を付与した別トークンを作成してください。Jira 用トークンとは別に発行する必要があります。

3. 認証情報の保存先

認証情報は 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>	展開先ディレクトリを指定

基本的な使い方

Jira

# 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"

Bitbucket

# リポジトリ一覧
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 出力

全コマンドで --json フラグが使用可能です:

atl jira issue list --jql "project = MYPROJ" --json

ライセンス

MIT License — 詳細は LICENSE を参照。

Documentation

Index

• Variables

Variables

var SkillsFS embed.FS