alpha-forge system¶

ワークスペース初期化・Whop OAuth 認証・同梱ドキュメント参照などの運用ユーティリティ群です。

alpha-forge system auth¶

Whop OAuth 2.0 PKCE による認証コマンド群。サブコマンドはすべて alpha-forge system auth <subcommand> で実行します。詳しい初回セットアップははじめにを参照。

ブラウザを開いて Whop で認証します。

alpha-forge system auth login

ブラウザが自動で開き、Whop の OAuth 認証フローを実行します。引数・オプションなし。成功すると認証情報が $XDG_CONFIG_HOME/forge/credentials.json（未設定時 ~/.config/forge/credentials.json）にキャッシュされます。

alpha-forge system auth logout¶

ログアウトして認証情報を削除します。

alpha-forge system auth logout

credentials.json を削除します。引数・オプションなし。Whop マイページのメンバーシップ自体は影響を受けません。

alpha-forge system auth status¶

現在の認証状態を表示します。

alpha-forge system auth status

サンプル出力：

ユーザー ID      : user_abc123
アクセストークン: 2026-04-12 12:30 UTC（あと 45 分）
最終検証        : 2026-04-12 11:45 UTC（13 分前）
プラン          : annual

未認証時は次のように案内します：

[AlphaForge] ログイン情報がありません。
  実行: alpha-forge system auth login

開発スキップ環境変数（ALPHA_FORGE_DEV_SKIP_LICENSE=1）が有効な場合は [AlphaForge] 開発スキップ中（EULA/認証は未完了） を表示します。

alpha-forge system auth check op¶

1Password CLI（op）のセッション有効性を検証します。.env.op を併用するチームの CI フックで使用するためのもの（issue #411）。詳細は実装コメントを参照。

alpha-forge system auth check op [--json]

セッション有効時に exit code 0、無効時に exit code 2 を返します。

alpha-forge system init¶

作業ディレクトリを初期化します。forge.yaml、データディレクトリ、ドキュメント、AI アシスタント統合ファイルを作成。

構文¶

alpha-forge system init [OPTIONS]

オプション¶

名前	種別	デフォルト	説明
`--force` / `-f`	フラグ	false	既存ファイルを確認なしで上書き
`--no-claude`	フラグ	false	AI アシスタント統合ファイルのセットアップをスキップ

作成されるディレクトリ¶

data/historical/、data/strategies/、data/results/、data/journal/、data/ideas/、output/pinescript/

インストールされる AI 統合ファイル¶

出力先	内容
`.claude/skills/`	Claude Code スキル（forge-backtest, forge-analyze, forge-data）
`.claude/commands/`	Claude Code スラッシュコマンド（explore-strategies, grid-tune 他 4 件）
`.agents/skills/`	Codex スキル（explore-strategies, grid-tune 他 4 件）

サンプル出力¶

AlphaForge: 作業ディレクトリを初期化します...

[1/4] 設定ファイル
  ✓ forge.yaml

[2/4] データディレクトリ
  ✓ data/historical/
  ✓ data/strategies/
  - 既存: data/results/
  ...

[3/4] ドキュメントファイル
  ✓ docs/quick-start.ja.md
  ✓ docs/user-guide.ja.md
  ...

[4/4] AI アシスタント統合ファイル
  ✓ .claude/skills/forge-backtest/SKILL.md
  ✓ .claude/commands/explore-strategies.md
  ✓ .claude/commands/grid-tune.md
  ✓ .agents/skills/explore-strategies/SKILL.md
  ✓ .agents/skills/grid-tune/SKILL.md
  ...

完了: 26 件を作成, 0 件をスキップ

次のステップ:
  1. forge.yaml を編集して設定をカスタマイズしてください
  2. 以下を ~/.zshrc / ~/.bashrc に追加してください:
     export FORGE_CONFIG=/path/to/forge.yaml

alpha-forge system docs¶

alpha-forge に同梱されているドキュメント・スキル・コマンド参考資料を参照します。

alpha-forge system docs list¶

alpha-forge system docs list

利用可能な同梱ドキュメントの一覧を表示します。✓ / ✗ でファイル存在を表します。

alpha-forge system docs show¶

alpha-forge system docs show <NAME>

名前	種別	説明
`NAME`	引数（必須）	ドキュメント名（`alpha-forge system docs list` で確認）

ドキュメントの内容を標準出力に表示します。未知の名前を指定すると利用可能リストとともにエラー表示し、終了コード 1。