Keyfold

Keyfold core

Keyfold のオープンソース部分です。開発者向けのオフライン優先型ボルトで、プロジェクトと環境ごとに整理した API キーやパスワードを、1 つの暗号化ファイルに保存します。アカウント不要、クラウド不使用、テレメトリーなしです。

Mac 用の Keyfold アプリは、これらのクレートを基盤に構築されています（Windows 版は Microsoft Store を通じて近日公開予定です）。keyfold.app/download から入手できます。署名済みビルドはリリースページにもあります。

内容

クレート	機能
crates/keyfold-core	Argon2id による鍵導出、XChaCha20-Poly1305 エンベロープ暗号化、改ざん検知可能なボルト形式、世代バックアップ、Recovery Kit、.env の解析、鍵検出パターン、2FA コード（RFC 6238）、オフラインでの Ed25519 ライセンス検証
crates/keyfold-agent	keyfold CLI と実行中のアプリ間で、所有者のみがアクセスできるローカルソケットを介してやり取りする JSON 行プロトコル
crates/keyfold-cli	keyfold コマンドラインと、Cursor および Claude Code 用の MCP サーバー。どのツールも秘密の値を返しません。すべてのリクエストはアプリで承認されます

AI エージェントで使う（MCP）

keyfold mcp を使うと、Claude Code、Cursor、Codex、Gemini CLI などの MCP クライアントが、モデルに API キーを見せることなく利用できます。7 つのツールで、プロジェクト名とキー名の一覧表示、承認した .env ファイルの書き込み、キーを注入したコマンドの実行、キーの保存、プロジェクトの作成、.env ファイルのインポートができます。どのツールも秘密の値を返しません。すべてのリクエストは Keyfold アプリでクリックして承認するまで待機し、キーを使用するコマンドまたはファイルが表示されます。

1. Keyfold for Mac をインストールします。アプリで「設定」›「一般」›「コマンドラインと MCP」を開き、「インストール」をクリックすると、keyfold が PATH に追加されます。
2. サーバーをクライアントに追加します。

claude mcp add --scope user keyfold -- keyfold mcp

Cursor（.cursor/mcp.json）：{ "mcpServers": { "keyfold": { "command": "keyfold", "args": ["mcp"] } } }

承認したコマンドがキーを出力することはあり、その出力はモデルに読み取られます。MCP ガイドでは、その点と 1 時間の承認について説明しています。サーバーを使うには、同じ Mac 上で Keyfold アプリが起動し、ロック解除されている必要があります。Dockerfile は Linux 上でのみビルドされます。これは、MCP ディレクトリがツール一覧を読み取れるようにするためです。

MCP レジストリ名：mcp-name: io.github.codewithkolin/keyfold

ドキュメント

• ボルト形式：ファイルのすべてのバイトと、その認証方法について説明します。
• 脅威モデル：Keyfold が保護する対象と、保護できない対象について説明します。
• MCP と CLI のガイド：キーを見せずに AI エージェントを接続する方法を説明します。

ビルドとテスト

cargo test --workspace
cargo clippy --workspace --all-targets -- -D warnings
cargo build --release -p keyfold-cli   # the `keyfold` binary

Rust stable が必要です。ほかのツールチェーンは必要ありません。

セキュリティ

脆弱性は非公開で報告してください。詳しくは SECURITY.md をご覧ください。

ライセンス

AGPL-3.0-only です。各クレートの LICENSE ファイルをご覧ください。これらのクレートを使用した Keyfold デスクトップアプリはプロプライエタリです。