mcpField
F
forgejo-cli-ops

forgejo-cli-ops

github.com/daisuke897開発048 回インストール1 週間前に更新
リポジトリ

forgejo-cli-ops について

forgejo-cli-opsは、`fj` CLIでForgejoに認証し、リポジトリ、Issue、PRの一般的な操作を行うためのスキルです。ホストの選択方法とログインのトラブルシューティングも扱います。

主な機能

  1. 01Forgejoの認証とアクセス確認
  2. 02`-H`または`FJ_HOST`によるホスト選択
  3. 03リポジトリ、Issue、PRの一般的なコマンド
  4. 04ログインとホスト不一致の調査
  5. 05`secret-tool`による任意のトークン保存

活用シーン

  1. 01Forgejoホストへの`fj`アクセス設定
  2. 02アカウントと認証状態の確認
  3. 03Issue、PR、リポジトリのコマンド実行
  4. 04ホスト選択に起因するログイン失敗の調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/daisuke897/dotfiles --skill forgejo-cli-ops

インストール後、Claude Code で/forgejo-cli-opsを入力して読み込まれたか確認します。

詳細

対象範囲

  • Forgejo ホストで認証し、アクセスを確認します。
  • 正しいホストを指定して、一般的な issue／PR／リポジトリのコマンドを実行します。
  • ホストとログインの不一致をトラブルシューティングします。

前提条件

  • Forgejo の Web UI で作成した Personal Access Token（PAT）。
  • fj がインストールされ、PATH から利用できること。
  • 任意：トークンを安全に保存するための secret-tool（GNOME Keyring）。

ホストの使用方法（重要）

-H/--host はグローバルオプションで、サブコマンドより前に指定する必要があります。

fj -H <FORGEJO_HOST> repo view <owner>/<repo>

ホストの指定を繰り返さないように、FJ_HOST を設定します。

export FJ_HOST=<FORGEJO_HOST>

認証（secret-tool の例）

トークンを保存して（初回のみ）、fj に登録します。

echo -n "<PAT_VALUE>" | secret-tool store --label="Forgejo PAT" service forgejo user <username>@<FORGEJO_HOST>
echo -n "$(secret-tool lookup service forgejo user <username>@<FORGEJO_HOST>)" | fj -H <FORGEJO_HOST> auth add-key <username>

確認します。

fj -H <FORGEJO_HOST> auth list
fj -H <FORGEJO_HOST> whoami

クリーンアップ

fj auth logout <FORGEJO_HOST>
secret-tool clear service forgejo user <username>@<FORGEJO_HOST>

トラブルシューティング

  • Error: not logged in は、ホストがデフォルトで github.com になっていることを示す場合がよくあります。-H を追加するか、FJ_HOST を設定してください。
  • secret-tool lookup で何も返されない場合は、キーリングのロックを解除するか、保存されているユーザー／ホストのキーを確認してください。

コメント

Markdown 対応