Capriとは？
Capriは、サイバーパンクをテーマにしたWindows向けのオープンソースAIエージェントです。AIアシスタントを通じて、ファイル、プロジェクトフォルダー、コード、シェルツール、アプリケーション、Webを操作するためのネイティブデスクトップインターフェースを提供します。ターミナルコマンドを書く代わりに、自然言語で目的を説明すると、Capriが作業を調整して実行します。
Capriはインターフェースとツール層として機能し、AIによる推論は外部アシスタントが担います。標準でClaude Code、Codex、Antigravityに対応しています。その他のアシスタントも、カスタムアダプターを通じて接続できます。
Capriは、サイバーパンク作品および『Cyberpunk: Edgerunners』に着想を得た、独立した非公式のファンプロジェクトです。CD PROJEKT RED、Netflix、Studio Trigger、Anthropic、OpenAI、Googleとは提携・承認関係にありません。
主な機能
- 複数のAIエンジン: Claude Code、Codex、Antigravity、またはカスタムアダプター経由の別のアシスタントを接続できます。
- Windowsネイティブインターフェース: ターミナルを直接操作する代わりに、インストール済みのデスクトップアプリケーションを使用できます。
- ファイルおよびプロジェクトツール: ファイルやプロジェクトフォルダー全体を検索、読み取り、整理、編集できます。
- エージェントワークフロー: Capriはタスクを計画し、ツールを要求し、結果を確認して、実行内容を報告できます。
- コード支援: 選択したエンジンにコードの作成、リファクタリング、デバッグ、実行を依頼できます。
- 承認コントロール: 機密性の高い操作を確認し、Capriがシステムを変更する前に承認または拒否できます。
- 設定可能な範囲: アクセス対象を選択したフォルダーに制限し、確認、自動、読み取り専用の権限動作を選択できます。
必要条件
Capriには現在、Windows 10以降が必要です。Windows用の.exeインストーラーとして配布されています。macOS版とLinux版はプロジェクトのロードマップに掲載されていますが、現在は利用できません。
また、対応するAIアシスタントのアカウントまたはAPIキーを自分で用意する必要があります。Capri自体はMITライセンスのオープンソースですが、接続するAIプロバイダーは独自の料金体系に基づいて利用料を請求する場合があります。
WindowsにCapriをインストールする
1. インストーラーをダウンロードする
Capriの最新リリースを開き、Capri-Setup.exeをダウンロードします。出所不明の第三者サイトではなく、公式リポジトリのリリースページを使用してください。
2. セットアップウィザードを実行する
Capri-Setup.exeを開きます。- インストールウィザードの指示に従います。
- インストール後、WindowsのスタートメニューからCapriを開きます。
Capriは新しいアプリケーションで、ダウンロード実績がまだ少ない可能性があるため、Windows SmartScreenに警告が表示されることがあります。公式リリースページからインストーラーを入手した場合は、詳細情報を選択し、続いて実行を選択して続行してください。
3. AIエンジンを接続する
初回起動時に、Capriはアシスタントの選択を求めます。Claude Code、Codex、Antigravity、またはその他の対応オプションを選択し、サインインするか、要求されたAPIキーを入力します。
リクエストは接続したアシスタントによって処理されます。そのため、その処理にはプロバイダーの利用規約、プライバシーポリシー、料金、アカウント規則が適用されます。
Capriがタスクを処理する方法
- 目的を説明する: デスクトップアプリケーションに自然言語でリクエストを入力します。
- Capriがエンジンを選択する: リクエストは設定済みのAIアシスタントに送られます。
- エンジンが計画を作成する: アシスタントが必要な手順とツールを判断します。
- Capriが機密性の高い操作を提示する: 権限設定に応じて、要求されたファイル操作やシステム操作を確認できます。
- 承認または拒否する: 承認した操作はCapriのツール層を通じて実行されます。
- Capriが結果を報告する: エージェントが結果を確認し、実行内容を要約します。
基本的な使用例
フォルダーを整理する
フォルダーを整理するには、対象の場所を指定し、希望する整理方法を説明します。
Downloadsフォルダーを整理して、ファイルを種類ごとにまとめてください。何かを移動する前に計画を表示してください。Capriはフォルダーをスキャンし、計画を提案して、ファイルを移動する前に承認を求めることができます。操作を承認する前に、移動先のフォルダーとファイル名を慎重に確認してください。
コードを調査して修正する
関連するプロジェクトフォルダーを開くかアクセスを許可し、Capriに具体的なリクエストを伝えます。
このプロジェクトのバグを見つけ、原因を説明して修正し、利用可能なチェックを実行してください。選択したAIエンジンはコードを調査し、問題の可能性が高い箇所を特定し、関連ファイルを編集してチェックを実行できます。より安全に確認するには、プロジェクトを変更する前に、提案された変更内容をCapriに説明させてください。
ドキュメントを要約する
Capriは、許可されたフォルダー内の複数ファイルを処理できます。たとえば、次のように依頼できます。
このフォルダー内のすべてのPDFを要約し、1つの統合された要約ドキュメントにまとめてください。タスクを承認する前に、Capriが読み取るフォルダーと、生成したドキュメントの保存先を確認してください。
Webプロジェクトを作成する
開発ワークフロー全体を依頼することもできます。
このフォルダーに新しいWebアプリをセットアップし、依存関係をインストールして起動してください。この種のリクエストでは、ファイルの作成、パッケージのダウンロード、シェルコマンドの実行、プロセスの起動が行われる可能性があります。承認する前に、提案されたフレームワーク、コマンド、対象ディレクトリを確認してください。
権限と範囲を設定する
READMEには、次の設定例が記載されています。
engine: claude-code
permissions:
mode: ask
allowed_folders:
- ~/Documents
- ~/Projects
interface:
theme: cyberpunkengineの値は、接続するアシスタントを選択します。文書化されている値には、claude-code、codex、antigravity、customがあります。
permissionsセクションでは、文書化されている次の3つのモードを使用できます。
ask：Capriは実行前に確認します。エージェントの動作を学ぶ際に最適な開始設定です。auto：アクションを自動的に実行できます。タスクを理解し、対象範囲を厳密に制限している場合にのみ使用してください。read-only：変更を許可せず、Capriを調査や分析に使用します。
allowed_foldersリストは、エージェントがアクセスできる場所を制限します。ドライブ全体やユーザープロファイル全体ではなく、特定の作業ディレクトリへのアクセスを許可してください。
高度なヒント
明確な境界を設けてプロンプトを書く
対象フォルダー、望む結果、検証方法、確認が必要なアクションを明記します。正確な依頼は曖昧さを減らします。
Projectsフォルダー内のプロジェクトを確認してください。テストが失敗している原因を特定し、提案する編集内容を説明したうえで、ファイルを変更する前に承認を待ってください。承認後、既存のテストスイートを実行してください。読み取り専用モードから始める
不慣れなリポジトリやドキュメント群では、read-onlyアクセスから始めてください。Capriに資料を調査させ、計画を提案させます。編集を許可する準備ができたときだけ、権限モードを変更してください。
分離したプロジェクトフォルダーを使用する
実験的な作業を専用フォルダーにコピーし、そのディレクトリだけへのアクセスをCapriに許可します。これにより、誤った変更を抑え、作成されたファイルの差分を確認しやすくなります。
計画と実行を分ける
大規模なタスクでは、まず変更を加えずに計画を依頼します。手順を確認した後、承認した部分だけを実行するよう2回目の指示を出します。これは、大量のファイル操作、依存関係のインストール、広範なリファクタリングで特に役立ちます。
適切なときにエンジンを切り替える
Capriでは、対応するAIエンジンから選択できます。複数のアシスタントのアカウントを管理している場合は、現在のタスクに最適なものを選んでください。各プロバイダーには、それぞれ異なる機能、費用、プライバシー規約がある点に注意してください。
カスタムアダプターは慎重に使用する
その他のアシスタントは、カスタムアダプターを通じて統合できます。使用する場合は、認証情報、リクエスト、ツール呼び出し、返却データの扱いを確認してください。READMEにはアダプターの実装手順が記載されていないため、統合を構築する前に、プロジェクトの最新ドキュメントまたはコントリビューション向けリソースを確認してください。
ロードマップの機能がすべて利用できるとは限らない
ロードマップに記載されているプラグインシステム、音声操作、タスクスケジューラー、テーマギャラリー、macOS版とLinux版は、完成済みではなく計画中です。これらの機能を前提にワークフローを設計する前に、最新のリリースノートを確認してください。
安全ガイドライン
- 機密性の高いアクションはすべて確認する：削除、移動、置換、シェルコマンド、依存関係のインストールには特に注意してください。
- フォルダーへのアクセスを制限する：現在のタスクに必要なファイルだけを公開してください。
- バックアップを保持する：大量の整理、自動編集、その他の大規模な操作を行う前に、重要なデータをバックアップしてください。
- 認証情報を保護する：APIキー、アカウントトークン、その他の秘密情報を決して共有しないでください。
- 生成されたコマンドを確認する：Capriに実行させる前に、シェルコマンドの内容を理解してください。
- バージョン管理を使用する：コードプロジェクトでは、大幅な編集を依頼する前に、コミットするか別の方法で現在の状態を保持してください。
セキュリティ問題を発見した場合は、プロジェクトのセキュリティ報告手順に従い、非公開で報告してください。
トラブルシューティングとプロジェクトリソース
インストーラー、エンジン接続、またはエージェントのワークフローが期待どおりに動作しない場合は、CapriのGitHubリポジトリと最新のリリースノートを確認してください。バグや機能のアイデアは、プロジェクトのIssueフォームから提出できます。
バグ報告、ドキュメント、テーマ、機能提案、エンジンアダプターなどの分野で貢献を歓迎しています。変更を提出する前に、リポジトリのコントリビューションガイドを確認してください。
まとめ
Capriは、Windowsユーザーが対応するAIアシスタントにファイル、プロジェクト、コードを操作させるためのデスクトップインターフェースを提供します。アプリケーションをインストールし、使用するエンジンを接続して、必要なフォルダーへのアクセスを制限し、承認ベースまたは読み取り専用の権限から始めてください。AIエージェントにコンピューター上で操作させる場合、明確なプロンプト、慎重な確認、バックアップ、限定的なアクセス境界が不可欠です。