Communityコーディング＆開発github.com

Epic Games CLI (Legendary)

Epic Games Launcherに代わる無料のオープンソースCLIツールです。ターミナルからゲームのインストール、起動、クラウドセーブの同期、ライブラリの管理などが行えます。

Epic Games CLI (Legendary) とは？

このスキルは、AIエージェント（Claude Code、Cursor、Codexなど）がEpic GamesストアのゲームライブラリをCLIで管理するためのツール「Legendary」を操作するために設計されています。Legendaryは公式ランチャーに依存せず、Python環境（3.9+）で動作し、pipで簡単にインストールできます。主な機能は、ゲーム一覧表示、インストール・アンインストール、起動（オフラインモードやWine/Proton経由のクロスプラットフォーム対応）、クラウドセーブの同期、Epic Games Launcherからのインポートなど、ほぼすべての管理タスクをカバーします。ユーザーはエージェントに自然言語で指示（例：「Anemoneをインストールして」「クラウドセーブを同期して」）を与えるだけで、Legendaryのコマンドが自動的に実行されます。このスキルは、開発者やパワーユーザーがEpic Gamesライブラリをターミナルから効率的に操作したい場合に特に有用で、GUIランチャーが不要な環境や自動化スクリプトへの統合に最適です。

対応~Claude Code~Codex CLI~Cursor
npx skills add Carton/agent-skills

Installed? Explore more コーディング＆開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

オリジナルを見る→すべてのスキルを見る

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

ドキュメント

Epic Games CLI (Legendary) は何をしますか？

Legendaryは、Epic Games Launcherに代わるフリーかつオープンソースのコマンドライン版です。ユーザーがターミナルからEpic Gamesライブラリを管理したい場合（ゲームのインストール、起動、クラウドセーブの同期、コレクションの参照など）にこのスキルを使用してください。

インストール

前提条件:

  • Python 3.9+ (64ビット)
  • pipパッケージマネージャー

PyPIからインストール（推奨）:

pip install legendary-gl

ウェブブラウザログインをサポートする場合:

pip install legendary-gl[webview]

別の方法: ソースからインストール

git clone https://github.com/derrod/legendary.git
cd legendary
pip install .

初期設定

認証

最初に、Epic Gamesアカウントで認証します:

# 標準認証（ブラウザが開きログイン画面が表示されます）
legendary auth

# Epic Games Launcherから既存のセッションをインポート（EGLからログアウトされます）
legendary auth --import

ブラウザベースの認証では以下の手順が行われます:

  1. デフォルトのブラウザでEpic Gamesログイン画面が開く
  2. Epicアカウントでログインするよう促される
  3. 認証コードが表示される
  4. ターミナルに戻ると自動的にセッションが保存される

確認

ログイン状態を確認:

legendary whoami

設定は ~/.config/legendary/config.ini（Linux/macOS）または %APPDATA%\legendary\config.ini（Windows）に保存されます。

コマンド概要

コマンド説明
legendary authEpic Gamesで認証
legendary listライブラリ内の全ゲームを表示
legendary list-installedインストール済みゲームを表示し、アップデートを確認
legendary install <app>ゲームをインストール/ダウンロード
legendary launch <app>ゲームを起動/プレイ
legendary uninstall <app>ゲームをアンインストール
legendary sync-savesクラウドセーブを同期
legendary egl-syncEpic Games Launcherと同期

一般的なユースケース

ゲームライブラリの参照

# Epic Gamesライブラリの全ゲームを表示
legendary list

# 詳細情報付きで表示
legendary list --csv

# メタデータを強制リフレッシュ（リストが古い場合に便利）
legendary list --force-refresh

# Unreal Engineコンテンツのみ表示
legendary list --include-ue

インストール済みゲームの管理

# インストール済みゲームを表示
legendary list-installed

# インストール済みゲームのアップデートを確認
legendary list-installed --check-updates

# 特定のゲームをアップデート
legendary update <app-name>

# すべてのインストール済みゲームをアップデート
legendary update --skip-dlc

ゲームのインストール

# ゲームをインストール（listコマンドで表示されるアプリ名を使用）
legendary install Anemone

# カスタムディレクトリにインストール
legendary install <app-name> --base-path /path/to/games

# 特定のプラットフォームでインストール
legendary install <app-name> --platform Windows

# DLCを含めてインストール
legendary install <app-name> --include-dlc

# 選択的ダウンロードを無効にしてインストール（全コンポーネントを取得）
legendary install <app-name> --disable-sdl

# サイレントインストール（確認プロンプトなし）
legendary install <app-name> -y

ゲームの起動

# ゲームを起動
legendary launch "world of goo"

# オフラインモードで起動
legendary launch <app-name> --offline

# 実行せずに起動コマンドを表示
legendary launch <app-name> --dry-run

# カスタムパラメータで起動
legendary launch <app-name> --override- exe "path/to/exe" --working-dir "path/to/dir"

クラウドセーブ管理

# すべてのクラウドセーブを同期（アップロードとダウンロード）
legendary sync-saves

# ダウンロードのみ（アップロードしない）
legendary sync-saves --skip-upload

# ローカルが新しい場合でも強制ダウンロード
legendary sync-saves --force-download

# 古いクラウドセーブをクリーンアップ
legendary clean-saves

ゲーム情報

# ゲームの詳細情報を取得
legendary info <app-name>

# ゲームマニフェスト内のファイル一覧を表示
legendary list-files <app-name>

# ゲームの利用可能なクラウドセーブを表示
legendary list-saves <app-name>

既存ゲームのインポート

Epic Games Launcherでインストール済みのゲームがある場合:

# Epic Games Launcherからゲームをインポート
legendary import-game <app-name> "/path/to/epic/install/dir"

# Epic Games Launcherと1回だけ同期
legendary egl-sync --one-shot

# EGLと継続的に同期（macOSでは利用不可）
legendary egl-sync

便利なエイリアス

~/.config/legendary/config.ini にエイリアスを作成:

[Legendary.aliases]
; エイリアス = アプリ名
HITMAN 3 = Eider
gtav = 9d2d0eb64d5c44529cece33fe2a46482

コマンドでエイリアスを使用:

legendary launch HITMAN 3
legendary install gtav

コマンドリファレンス

legendary list [options]

オプション説明
--platform <p>プラットフォーム（Windows/Mac）でフィルタ
--include-ueUnreal Engineコンテンツを含める
-Tターミナル書式を無効化
--csvCSV形式で出力
--tsvTSV形式で出力
--jsonJSON形式で出力
--force-refreshすべてのメタデータを強制リフレッシュ

legendary install <app-name> [options]

オプション説明
--base-path <path>カスタムインストールディレクトリ
--platform <p>特定のプラットフォーム
--include-dlcDLCをインストール
--disable-sdl選択的ダウンロードを無効化
--reset-sdl選択的ダウンロードの選択をリセット
--skip-dlダウンロードをスキップし、インストールのみ
-yすべてのプロンプトを自動確認
--updateすでにインストール済みの場合はアップデート

legendary launch <app-name> [options]

オプション説明
--offlineオフラインモードで起動
--dry-run実行せずにコマンドを表示
--json起動情報をJSONで出力
--override- exe <path>カスタム実行ファイル
--working-dir <path>カスタム作業ディレクトリ

legendary sync-saves [options]

オプション説明
--skip-uploadセーブデータのダウンロードのみ
--force-downloadローカルを上書きして強制ダウンロード
--force-uploadリモートを上書きして強制アップロード

高度な機能

クロスプラットフォームゲーム

# Proton/WINEを介してLinuxでWindowsゲームを実行
legendary install <app-name> --platform Windows
legendary launch <app-name> --wine

# CrossOverを介して実行（macOS）
legendary launch <app-name> --crossover-bottle <bottle-name>

選択的ダウンロード

Legendaryはディスク容量を節約するための選択的ダウンロードをサポートしています:

# 選択的ダウンロードを有効にしてインストール
legendary install <app-name>

# SDL選択をリセット
legendary install <app-name> --reset-sdl

# SDLを無効化（全コンポーネントを取得）
legendary install <app-name> --disable-sdl

設定

~/.config/legendary/config.ini を編集:

[Legendary]
max_memory = 2048           ; 最大共有メモリ（MB）
max_workers = 8             ; 最大ワーカープロセス数
install_dir = ~/Games       ; デフォルトインストールディレクトリ

トラブルシューティング

認証の問題

認証が失敗する場合:

# 既存のセッションをクリア
legendary auth --delete

# 再認証
legendary auth

ゲームが起動しない

  1. ゲームがオンライン認証を必要としているか確認:

    legendary launch <app-name>

  2. DRMが許可していればオフラインモードを試す:

    legendary launch <app-name> --offline

  3. --dry-run で起動コマンドを確認:

    legendary launch <app-name> --dry-run

ダウンロードが遅い

設定で最大ワーカー数を調整:

[Legendary]
max_workers = 16
max_memory = 4096

Epic Games Launcherからのインポート

macOS版のEGLはインポートをサポートしていません。以下を使用:

# Windows/Linuxの場合
legendary egl-sync

リソース

制限事項

  • ゲームの購入は不可（所有しているゲームのみダウンロード可能）
  • 無料ゲームの請求は不可（ウェブストアまたはEGLを使用する必要があります）
  • macOSでのEGL同期はサポートされていません（EGLの制限による）
  • ターミナル操作が必要（GUIはありません）

代替ツール

GUI体験が必要な場合:

関連スキル

steipete/bluebubbles

Send and manage iMessages via BlueBubbles, including attachments, tapbacks, edits, replies, and groups.

community

steipete/eightctl

Control Eight Sleep pods (status, temperature, alarms, schedules).

community

steipete/blucli

BluOS CLI (blu) for discovery, playback, grouping, and volume.

community

steipete/bear-notes

Create, search, and manage Bear notes via grizzly CLI.

community

steipete/camsnap

Capture frames or clips from RTSP/ONVIF cameras.

community

steipete/gifgrep

Search GIF providers with CLI/TUI, download results, and extract stills/sheets.

community
← More コーディング＆開発 skills