rust-anything — 既存アプリの動作を記録・検証しながら段階的にRustへ移行するCLIツール
erkamyaman/rust-anything
★ 1,499 ・ Rust ・ MIT
概要
rust-anything は、既存のアプリケーションやライブラリをRustへ段階的に書き直すプロセスを支援するCLIツールです。TypeScript/JavaScript、Python、C、Go、Ruby、Java、そしてプレビュー段階のPHPやC#といった言語で書かれたCLIツール、HTTPサーバー、ライブラリに対応しています。
本ツールの最大の特徴は、「既存の動作を記録し、書き直したRustコードがその記録と完全に一致するかをステップごとに検証する」というアプローチを採っている点です。大規模な書き換えで生じがちなリグレッションを防ぎながら、ボトルネックとなっているホットパスのみを部分的にRustへ置き換える、あるいはアプリケーション全体を最終的に純粋なRust実装へ移行する作業を安全に進めることができます。
なお、rust-anything 自体はコードを自動的にRustへ変換するトランスパイラではありません。Rustコードの実装は開発者自身、またはClaude CodeやCursorといったコーディングエージェントが行い、本ツールはその前後の計測、インターフェース生成、挙動の記録・検証、ベンチマーク判定を担います。パフォーマンス改善のために一部をRust化したい開発者や、AIエージェントを活用した安全なリライト基盤を求めている開発者に向いています。
主な特徴
-
振る舞いの記録と差分検証(Record & Diff) 元のコードを実行してエッジケースや入出力の挙動を記録し、Rustによるリライトコードがその記録と完全に同一の結果を返すかをコマンド1つで検証できます。
-
マルチ言語対応と各言語向けブリッジの自動生成 TypeScript(napi-rs、wasm-bindgen)、Python(PyO3)、C(extern “C”)、Go(cgo)、Ruby(magnus)、Java(JNI)に対応し、元のAPIシグネチャを維持したままRustを呼び出す連携コード(ブリッジ)を生成します。
-
段階的な移行ループ プロファイリングから移行計画の策定、ブリッジ生成、記録、差分検証、ベンチマーク、本番での並行稼働(シャドウイング)、品質ゲート判定までの一貫した移行パイプラインが定義されています。
-
主要AIコーディングエージェントとの統合 Model Context Protocol(MCP)サーバーおよびスキルとしての組み込みに対応しており、Claude Code、Codex、Cursor、Gemini CLIなどのエージェントと連携して移行作業を対話的に進められます。
-
ホットパスに特化したバッチ処理のサポート 単一の小さな関数呼び出しを繰り返すオーバーヘッドを抑えるため、Rust側にデータを一度渡してマルチコアで一括処理するバッチクラス(
--batch)の生成に対応しています。
使い方
インストールとセットアップ
Rustのツールチェーンがある場合は、cargo を使用してインストールします。
cargo install rust-anything
rust-anything setup
rust-anything setup を実行すると、環境内に存在する Claude Code、Codex、Cursor、Gemini CLI を検出し、MCP サーバーやスキルの設定を自動的に登録します。既存の設定ファイルを変更する前にはバックアップ(.rust-anything.bak)が作成されます。
また、Rust環境がない場合でも、GitHubのReleasesからmacOS、Linux、Windows向けのビルド済みバイナリを取得できるほか、JavaScript環境向けにはnpm経由でのグローバルインストールも提供されています。
npm install -g rust-anything
Claude Codeでは、プラグイン機能を利用して導入することも可能です(CLIがPATHに通っている必要があります)。
/plugin install rust-anything --marketplace erkamyaman/rust-anything
基本的な実行手順(手動で進める場合)
エージェントに任せず自身で移行ステップを実行する場合、READMEでは以下のコマンド例が示されています。
-
プロファイリング:負荷の高いホットパスを特定します。
rust-anything profile . -- node bench.mjs -
ブリッジの生成:元のAPIを維持したRustクレートとラッパーを生成します。
rust-anything bridge . src/fuzzy.ts --batch fuzzyScore:text -
記録とビルド:Rustコード(
port.rs)を実装したのち、元の振る舞いを記録してRustをビルドします。rust-anything record rust/fuzzy-rs && rust-anything build rust/fuzzy-rs -
検証とベンチマーク:記録された全ケースとの一致を確認し、速度改善を測定します。
rust-anything diff rust/fuzzy-rs rust-anything bench rust/fuzzy-rs -
完了判定:すべての品質基準を満たしているかを判定します。
rust-anything gate rust/fuzzy-rs
コーディングエージェントを利用する場合
セットアップ完了後、エージェントに対して指示を出すことで移行作業を進められます。READMEには以下のようなプロンプト例が挙げられています。
- 「rust-anythingを使ってこのCLIを端から端までRustで書き直し、同一の振る舞いを証明してほしい」
- 「この検索処理が遅いため、rust-anythingでプロファイリングしてホットループをRustに移行してほしい」
- 「
src/parser/のRust移行計画を立て、最初のユニットを移植してテストしてほしい」
技術的なポイント
FFI・バインディング技術の使い分け
rust-anything は各言語の特性に応じたインターフェース連携手段を採用しています。
- TypeScript/JavaScript:
napi-rsまたはwasm-bindgenを使用し、バイナリワイヤプロトコルを生成。クラスや非同期処理(async)も対象に含まれます。 - Python:
PyO3(abi3)による直接変換と型付き例外のマッピングを行います。 - C:
extern "C"関数とCヘッダーを出力し、共有ライブラリ経由でctypesから呼び出してケースごとにプロセスをフォークして検証します。 - Go: 型付きの
cgo呼び出しとバイナリワイヤを用いて、元のAPIを持つGoパッケージを生成します。 - Ruby:
magnus拡張を利用し、元のモジュール構造の下で統合します。 - Java: 型付き
JNIとバイナリワイヤを用い、リフレクション対応のラッパークラスを生成します。
型情報の推論と自動判定
プロジェクトの言語は package.json、pyproject.toml、go.mod、pom.xml などの設定ファイルやリポジトリ内のソースコードから自動検出されます(--lang による明示指定も可能)。また、TypeScriptの型定義、Pythonの型ヒント、Go/Java/Cのシグネチャ、RubyのYARDタグ、phpdocなどから型情報を抽出し、型付けされていない引数でも数値として利用されている場合は数値型として推論する仕組みを持っています。
段階的移行のワークフロー設計
単一ユニットの移行にとどまらず、アプリケーション全体を段階的にRust化するアプローチ(--whole-app)が考慮されています。最初にRustでエントリポイント(フロントドア)を握り、背後で元の言語のコードを呼び出しつつ、ユニット単位で diff と gate を通過させながら徐々にRustへ置き換えていく構成を採ることができます。
注意点
-
コード自動変換ツールではない 本ツールはRustのコード自体を自動生成・変換するものではありません。Rust実装の作成は開発者本人またはLLMベースのエコーディングエージェントに委ねられています。
-
テスト・記録の網羅性への依存
recordおよびdiffによる動作保証は「記録されたケースがカバーしている範囲」に限定されます。READMEにも記載がある通り、元の挙動の記録に含まれていない未カバーのエッジケースや副作用については検知できません。 -
言語ごとの対応ステータス TypeScript、Python、C、Go、Ruby、Javaが基本対応となっていますが、PHPおよびC#はプレビュー段階です。PHPとC#に関しては、アプリ全体の記録・再生・Rustフロントドア配置は可能であるものの、ユニット単位のFFI連携(PHP FFIやP/Invoke)は後続の課題として開発が進められている状態です。
-
ライセンス 本リポジトリは MIT ライセンス のもとで公開されています。また、READMEにて「Rust ProjectおよびRust Foundationとは無関係の独立したプロジェクトである」旨が明記されています。
まとめ
rust-anything は、既存資産の振る舞いを記録・再生して互換性を担保しながら、安全にRustへの移行を進めるための支援フレームワークです。各言語に対応したFFIブリッジの生成やMCPを通じたAIエージェントとの連携機構が整っており、ホットパスの高速化からアプリ全体のリライトまで、確実性を重視した移行作業を行う際に役立つツールです。





