Atelier

Atelier は、コマンドラインツールや AI エージェント向けの、オフラインで動作するヘッドレスのピクセルアートエディターです。レイヤー付きのスプライトやアニメーションを作成し、ピクセルを確認して、PNG、スプライトシート、GIF、APNG、TrueType ピクセルフォントを書き出せます。ドキュメントはローカルに保存されます。

シェルから直接使うか、MCP（Model Context Protocol）経由で Claude Code や Codex などのエージェントに接続できます。どちらのインターフェイスでも同じ編集ツールを使えます。CLI の呼び出しにグラフィカルエディターや実行中のサーバーは必要ありません。

エージェントが Atelier のツールを使って描画しました。それぞれ、CI で隣にあるレシピからバイト単位で完全に再現されます。

物理シミュレーションと Atelier MCP を Opus 5.5 で組み合わせて作成した、より複雑なデザインです。

リプレイファイルは大きすぎるため、ここには含めていません。 必要な場合はGoogle Driveからダウンロードしてください。

ショーケース

• アニメーションのショーケース — モデルやブリーフを比較し、アニメーションを表示して、リプレイをダウンロードできます。
• Frayed

インストール

macOS、Ubuntu、その他の Linux では、次のコマンドをターミナルに貼り付けてください。

curl -fsSL https://github.com/marmikshah/atelier/releases/latest/download/install.sh | sh

Ubuntu Desktop には curl が標準で付属していません。代わりに wget を使ってください。

wget -qO- https://github.com/marmikshah/atelier/releases/latest/download/install.sh | sh

このコマンドは、お使いのマシン用の Atelier をダウンロードして検証し、~/.local/bin に配置して、そのディレクトリを PATH に追加します。Claude Code または Codex がインストールされている場合は、Atelier との接続も設定します。これにより、すべてのプロジェクトで描画ツールと、スプライトやシーンの描画、アートのレビューに使えるガイドが利用できるようになります。Rust を含め、ほかに必要なものはありません。

その後、新しいエージェントセッションを開始して、次のように依頼してください。

atelier を使って 32×32 のアニメーションするたいまつを描き、torch.gif として保存してください。

アートは ~/.atelier に保存されます。プロジェクトのアートをプロジェクト内に保存するには、エージェントを開始する前に、そのフォルダーで atelier init を実行してください。

• 更新： インストールコマンドをもう一度実行してください。
• Claude Code または Codex を後からインストールしましたか？ atelier connect を実行してください。
• 特定のバージョンやフォルダーを指定する場合、またはプロファイルを変更しない場合： ATELIER_VERSION、ATELIER_INSTALL_DIR、または ATELIER_NO_MODIFY_PATH=1 を設定してください。install.sh にすべてのオプションが記載されています。

アンインストール

atelier uninstall

削除対象が一覧表示され、削除前に確認を求めます。Claude Code と Codex に登録された Atelier、スキル、追加された PATH の行、atelier プログラム、および設定している場合は Linux のバックグラウンドサーバーが対象です。

~/.atelier 内のアートは保持されます。削除する場合は --documents を追加してください。atelier init で設定したフォルダーには一切手を加えません。

その他の実行方法

• ターミナルから実行する。 各ツールは1つのコマンドで実行できます：atelier call TOOL '<json>'。最初のスプライトでは、画像の作成、描画、保存の手順を説明します。

• Cursor やその他の MCP クライアントで実行する。 上記の手順でインストールした後、command -v atelier が出力するパスを、引数なしの stdio サーバーとして登録し、描画ガイドを使うには atelier skills install --for cursor（または別のスキルフォルダーには --dir PATH）を実行します：

  {
    "mcpServers": {
      "atelier": {
        "command": "/full/path/to/atelier"
      }
    }
  }
  

• Docker で実行する。 Docker を起動できる MCP クライアント向けに、コンテナーイメージを公開しています。

• HTTP サーバーまたはバックグラウンドサービスとして実行する。 Atelier の実行を参照してください。

ソースからビルドする

その他のプラットフォームで使用する場合や、自分でビルドする場合は、Rust 1.98 以降をインストールしてから、次を実行します：

cargo install --locked --git https://github.com/marmikshah/atelier atelier
atelier connect

この方法でインストールしたビルドも、atelier uninstall で削除できます。これは cargo uninstall を通じて行われます。

やりたいこと…	まずはこちら
ターミナルからアートを作成する	はじめに
サーバーを実行する、Docker を使う、またはアートの保存先を選ぶ	Atelier の実行
ツールの引数を確認する	atelier tools --markdown または atelier tools --schema NAME
チェックアウトからビルドする、コードを理解する、またはショーケースに取り組む	開発ガイド
バグやセキュリティ上の問題を報告する	イシュー · セキュリティ

安定性

Atelier は 0.2 です。現在のソースは master です。リリースはここから配布され、macOS と Linux のバイナリ、コンテナーイメージ、vX.Y.Z タグ、MCP Registry エントリーが公開されます。

• ドキュメントが破棄されることはありません。 編集内容はジャーナルに記録され、アトミックにコミットされます。破損したドキュメントや、異なるドキュメントスキーマを使うビルドで保存されたドキュメントは、エラーとともに拒否され、ディスク上で変更されずに残ります。
• ドキュメント形式にはバージョンが付与されますが、移行はありません。 更新によって形式が変更された場合、変更前に保存されたドキュメントは拒否され、ディスク上で変更されずに残り、そのドキュメントを書き込んだコミットで再び開くことができます。
• レシピは、ドキュメントを作成した呼び出しをそのまま記録したログです。 1行につき1つの JSON が記録されます。レシピ自体にバージョンはありません。描画結果はツールの動作に依存するため、あるコミットで作成したレシピは、ツールが同じ方法で描画するコミットであれば正確に再生されます。
• ツール名と引数は、コミット間で変更される場合があります。 それらを使ってスクリプトを作成する場合は、コミットを固定し、現在の仕様を atelier tools --markdown で確認してください。

開発方法

このコードは100％AIによって書かれています。 Atelier は、ツール呼び出しだけを使うエージェントが、ゲームで役立つアートを作成できるかどうかを確かめる実験として始まりました。私は方向性を示してきました。この成果が、皆さん自身の作品づくりに役立つことを願っています。

CI では、フォーマット、厳格な Clippy、Linux と macOS での Rust テストスイートを確認し、コンテナーのスモークテストを実行します。また、すべてのショーケースレシピを再生し、GIF がバイト単位で一致することを確認します。セキュリティポリシーでは、ネットワークとファイルアクセスの境界について説明しています。

メモ

コードは行ごとの人手によるレビューを受けていません。 バグ、セキュリティ上の問題、破壊的変更が発生する可能性があります。本番環境で使用する前にコードを確認し、重要なデータのコピーを使って作業してください。

コントリビューション

バグ報告や質問は、イシューとして歓迎します。チェックアウトのコミットと、最小限のコマンド手順またはレシピファイルを記載してください。プロジェクト外からのプルリクエストは受け付けていません。脆弱性はセキュリティポリシーを通じて非公開で報告してください。

ライセンス

MIT © Marmik Shah