Sentry の CLI ツール sentry-cli を複数の組織 (Organization) で使いたいが、AWS CLI の --profile のようなネイティブなマルチプロファイル機能は存在しない。
brew install getsentry/tools/sentry-cli公式ドキュメント (Configuration and Authentication) によると、設定は以下の優先順位で読み込まれる:
-o, -p, --auth-token)SENTRY_AUTH_TOKEN, SENTRY_ORG, SENTRY_PROJECT).sentryclirc ファイルを検索~/.sentryclirc (グローバルデフォルト).sentryclirc はファイル名が固定で、リネームした別名のファイル(.sentryclirc-staging 等) は読み込まれない (参考)。
Sentry は MCP サーバー も提供しており、AI エージェントから直接 Sentry を操作できる。しかし、いくつかの課題がある:
結局、CLI ラッパー + AI エージェントのスキルという構成の方が、軽量かつ柔軟に扱える。
zsh の function は PATH 上の同名バイナリより常に優先されるため、sentry-cli という名前の function を定義するだけで、brew でインストールした本物の sentry-cli をラップできる。
~/.config/sentry-cli/profiles/<name>.env中身はシンプルな env ファイル:
SENTRY_AUTH_TOKEN=sntrys_xxx...
SENTRY_ORG=my-org
SENTRY_URL=https://my-org.sentry.io/SENTRY_PROJECT はプロファイルに固定せず、コマンド実行時に -p で指定する運用が良い。1つの org に複数の project があるのが普通なので。
~/.zshrc や alias ファイル等に以下の function を追加する:
# sentry-cli wrapper with --profile support
# Profiles: ~/.config/sentry-cli/profiles/<name>.env
function sentry-cli () {
local _sentry_cli
# whence -p: function を無視してバイナリのパスだけ返す
_sentry_cli=$(whence -p sentry-cli) || { echo "sentry-cli not found in PATH" >&2; return 1; }
local profile_dir="${HOME}/.config/sentry-cli/profiles"
local profile=""
local setup=0
local args=()
while [[ $# -gt 0 ]]; do
case "$1" in
--profile=*) profile="${1#--profile=}"; shift ;;
--profile) profile="$2"; shift 2 ;;
--profiles)
if [[ -d "$profile_dir" ]]; then
for f in "$profile_dir"/*.env(N); do
echo "${f:t:r}"
done
else
echo "No profiles directory: $profile_dir" >&2
fi
return 0
;;
--setup) setup=1; shift ;;
*) args+=("$1"); shift ;;
esac
done
# --setup: create or edit a profile
if [[ $setup -eq 1 ]]; then
if [[ -z "$profile" ]]; then
echo "Usage: sentry-cli --profile=<name> --setup" >&2
return 1
fi
mkdir -p "$profile_dir"
local pfile="${profile_dir}/${profile}.env"
if [[ -f "$pfile" ]]; then
echo "Editing existing profile: $profile"
else
echo "Creating new profile: $profile"
cat > "$pfile" <<TMPL
SENTRY_AUTH_TOKEN=
SENTRY_ORG=${profile}
SENTRY_URL=https://${profile}.sentry.io/
TMPL
fi
${EDITOR:-vim} "$pfile"
return 0
fi
# No profile: passthrough
if [[ -z "$profile" ]]; then
"$_sentry_cli" "${args[@]}"
return $?
fi
# Load profile and run
local pfile="${profile_dir}/${profile}.env"
if [[ ! -f "$pfile" ]]; then
echo "Profile not found: $pfile" >&2
echo "Run: sentry-cli --profile=${profile} --setup" >&2
return 1
fi
# サブシェルで source して現在の環境変数を汚さない
(
set -a
source "$pfile"
set +a
"$_sentry_cli" "${args[@]}"
)
}command -v の罠最初の実装では command -v sentry-cli でバイナリパスを取得していたが、zsh の command -v は同名の function 自身も返してしまうため、無限再帰になり maximum nested function level reached; increase FUNCNEST? エラーが発生した。
whence -p を使うことで、function を無視してバイナリパスだけを取得できる。これは zsh 固有のビルトインコマンド。
# プロファイル作成 (エディタが開く)
sentry-cli --profile=myorg --setup
# 接続確認
sentry-cli --profile=myorg info
# プロジェクト一覧
sentry-cli --profile=myorg projects list
# リリース一覧 (プロジェクト指定)
sentry-cli --profile=myorg releases list -p my-project
# プロファイル一覧
sentry-cli --profiles
# プロファイルなし (通常の sentry-cli として動作)
sentry-cli infoこのラッパーを Claude Code のスキルとしても登録した。SKILL.md を書いておくことで、AI エージェントが自然に sentry-cli --profile=xxx を使って Sentry を操作できるようになる。
以下がスキル定義の全体像:
---
name: sentry-cli
description: Sentry CLI のマルチプロファイル対応ラッパー。リリース管理・ソースマップアップロード・イベント送信など。
allowed-tools: Bash(sentry-cli:*)
---
# Sentry CLI (multi-profile wrapper)
Sentry CLI をマルチプロファイルで使うための zsh ラッパー。
## 重要: 操作前にヘルプを確認
sentry-cli のサブコマンドや引数が不明な場合、まずヘルプを読むこと。
sentry-cli --help
sentry-cli <subcommand> --help
## プロファイル管理
### プロファイル作成・編集
sentry-cli --profile=<name> --setup
### プロファイル一覧
sentry-cli --profiles
### プロファイルを指定して実行
sentry-cli --profile=<name> <subcommand> [options]
### プロファイルなしで実行 (通常の sentry-cli として動作)
sentry-cli <subcommand> [options]
## よく使うサブコマンド
- info: 接続情報と認証状態を確認
- releases: リリースの一覧・作成・ファイナライズ
- sourcemaps: ソースマップのアップロード
- send-event: テストイベントの送信
- deploys: デプロイの記録
- issues: イシューの一覧・解決
- projects: プロジェクトの一覧ポイントは:
allowed-tools: Bash(sentry-cli:*) で、エージェントに sentry-cli コマンドの実行を許可--help を読む指示を含めることで、サブコマンドの引数ミスを防ぐ--profile オプションで簡単に切り替えられるwhence -p を使わないと無限再帰になるので注意