ファイルとフォルダー

OAR は、自分が所有するものをすべて 1 つのフォルダー、つまり状態フォルダーに置きます。設定ファイル、会話を収めたデータベース、ログ、アップロードしたファイルです。このページでは、そのフォルダーの場所、中身、削除できる部分、シークレットを保持する部分、リレーが自動で削除するものを説明します。状態フォルダーにまったく入っていないデータもあります。各プロバイダーは、自分のセッションデータとサインイン情報を自分のフォルダーに保持します。

状態フォルダー #

npm install -g と oar update はパッケージを置き換えますが、状態フォルダーには一切触れません。OAR_STATE_ROOT は oar を実行するすべてのシェルで設定する必要があります。設定しないと、コマンドは既定のフォルダーを探します。環境変数を参照してください。oar doctor は、使用中のパス（状態フォルダー、設定ファイル、データベースとそのサイズ）を表示します。同じパスは、インストールの種類ごとにインストールにも記載しています。

3 つの環境変数で、個別の部分を移動できます。COPILOT_WEB_RELAY_CONFIG は設定ファイル、COPILOT_WEB_RELAY_DATA_DIR はデータフォルダー（データベース、ロック、アップロード）、COPILOT_WEB_RELAY_LOG_DIR はログフォルダーを移動します。config.json のキー dataDir でもデータフォルダーを移動できますが、環境変数が優先されます。相対パスの dataDir は、config.json のあるフォルダーを基準にします。

0.9.14 で追加 アップロードもデータフォルダーに従い、<dataDir>/uploads に置かれます。以前のバージョンが server/uploads に残したアップロードや、移行で状態フォルダーの uploads/ にコピーされたアップロードも、その場所のまま読み込まれます。

0.9.14 で追加 グローバルインストールのリレーは、どの方法で起動しても状態フォルダーのデータフォルダーを使います。oar start、Linux のサービス、Windows の 2 つの自動起動モード、OAR の拡張機能を使った素の gh copilot のいずれでも同じです。以前の自動起動のリレーが使っていた config.json の dataDir からは 1 回だけコピーし、元のフォルダーはそのまま残します。

macOS と Linux では、リレーはデータフォルダーを自分だけが読める状態（モード 700）にし、設定ファイルとデータベースのファイルをオーナーだけが使える状態（モード 600）にします。

古いインストールを移す #

プロジェクトの名前が変わる前は、状態は git チェックアウトの server/ フォルダーにあり、チェックアウトのランチャーの設定ファイルとログは ~/.config/copilot-remote（XDG の設定フォルダーが指定されていれば $XDG_CONFIG_HOME/copilot-remote、Windows では %LOCALAPPDATA%\copilot-remote）にありました。グローバルインストールは、最初の oar setup または oar copilot で、そのフォルダーの設定ファイルとログを状態フォルダーに 1 回だけコピーします。oar start は移行しません。データベースを含むチェックアウトの状態を取り込むには、次のようにします。

oar setup --migrate-from /home/dev/projects/old-oar

指定するのはチェックアウトそのもので、その server/ フォルダーではありません。処理の内容は次のとおりです。

• データベース（-wal と -shm のファイルを含む）、設定ファイル、data/ にあった Cursor のエージェントストア（データベースがあった場合のみ）、uploads フォルダー、そして 50 MB 以下の場合は logs フォルダーをコピーします。
• コピー元は決して変更しません。結果に納得したら、古いフォルダーは自分で削除してください。
• コピー元からリレーがまだ動いている間は実行を拒否し、その旨を表示します。
• コピーを有効とみなす前に検証します。データベースは SQLite の整合性チェックに合格し、会話とメッセージの数が一致している必要があります。そうでない場合は、コピーしたものを削除し（0.9.14 で追加 状態フォルダー全体は削除しなくなりました）、メッセージを残します。
• 0.9.14 で追加 決して上書きしません。状態フォルダーにすでにある config.json は残します。インストーラーのリレーが作った空のデータベースは backups/ に移します（先にリレーを止めてください：oar stop）。会話を含むデータベースがある場合は実行を拒否し、代わりにすべきことを表示します。データベースをコピーしている間はリレーのロックを保持するため、その間にそのデータベースでリレーが起動することはありません。
• 記録を backups/MIGRATION.md に、マーカーファイル .migrated を状態フォルダーに書き込みます。

0.9.14 で追加 移行したアップロードは、リレーが読み込む data/uploads/ に入り、Cursor のエージェントストアは、リレーが既定で読み込む data/cursor-agents/ に入ります。以前の移行が状態フォルダーの uploads/ に残したアップロードは、次のリレー起動時に data/uploads/ に統合されます。上書きや削除は一切されません。チェックアウト内のシンボリックリンクのフォルダーは、実際のフォルダーとしてコピーされます。

中身 #

パスは状態フォルダーからの相対パスです。「削除しても安全」とは、削除後もリレーが動作するという意味で、何を失うかについては何も述べていません。

状態フォルダーの外では、インストーラーの oar ランチャーが ~/.local/bin/oar にあり（~/.oar/npm にインストールする場合のみ）、Linux のサービスは ~/.config/systemd/user/oar.service です。これらの削除方法は OAR の削除で説明しています。0.9.15 で追加 oar uninstall はサービスとパッケージを削除し、状態フォルダーはそのまま残します。oar uninstall --purge は、delete と入力した後に状態フォルダーを削除します。

git チェックアウトは、同じファイルを server/ に保持します。生成された画像は状態フォルダーにはありません。状態フォルダーの外を参照してください。

データベース #

データベースは 1 つの SQLite ファイル copilot.db です。リレーが最初の起動時に作成します。あなたのデータと呼べるものは、ここに入っています。

• 会話とそのメッセージ（トランスクリプト、添付ファイルのインデックス、ピン留めしたメッセージを含む）
• メッセージキュー、キュー待ちのメッセージと待機中のメッセージ、エージェントがした質問
• Web UI で変更するリレーの設定（アプリ全体のスイッチ、プロバイダーの設定、保持期間の選択、更新の設定、モデルのリスト）
• OpenAI、Cursor、0.9.17 で追加 DeepSeek の API キー（入力した場合）
• ペアリングしたリレーとそのトークン、このリレーとペアリングしたリレーでセッションを監視する購読
• デバイスの Web Push の購読と、リレーのプッシュ用のキー
• 共有した会話のリンク
• 会話ごとのサブエージェントとワークフローの記録、アクティビティ、思考
• アップロードしたファイルのインデックスと、それを使うメッセージ
• Check Usage（使用状況の確認）のプランのメーター用の使用状況のスナップショット。0.9.17 で追加 DeepSeek カードが数えるもの：DeepSeek のターンのモデル別・日別のトークン数と検索数、各 DeepSeek セッションが最後に報告した合計、カードのバーの基準となる残高の読み取り値
• 画像チャット：その操作と、生成された画像同士のつながり
• プレビューのカード

マイグレーションは、リレーが起動するたびに自動で実行されます。足りないものを作成して列を追加するだけで、再実行しても何も変わりません。自分で実行することはなく、スキップすることもできません。

バックアップ #

OAR にはバックアップ用のコマンドはありません。データベースは SQLite の先行書き込みモードで動作するため、最近の変更がデータベースの隣の -wal ファイルに入っていることがあります。バックアップするには、次のようにします。

1. oar stop でリレーを止めます。
2. copilot.db と、存在する場合は copilot.db-wal と copilot.db-shm を一緒にコピーします。
3. リレーを再び起動します。

復元するには、リレーを止め、コピーしたファイルを元どおりに戻します。リレーの動作中に copilot.db だけをコピーしないでください。また、データベースのファイルと別のコピーの -wal ファイルを混ぜないでください。バックアップには API キーとトークンが含まれます（シークレットの保存場所を参照）。状態フォルダーと同じように、ほかの人が読めない場所に保管してください。

ログ #

Copilot の拡張機能エンジンには、ワーカーのログがありません。このエンジンは Copilot CLI 自身のターミナルだからです。systemd サービスとして実行したリレーは、ジャーナルにも書き込みます。リレーを自動で起動するを参照してください。

npm start で起動した git チェックアウトは、ログを server/logs に置きます。oar start または oar copilot で起動したものは、COPILOT_WEB_RELAY_LOG_DIR が別のフォルダーを指定していない限り、~/.config/copilot-remote/logs（Windows では %LOCALAPPDATA%\copilot-remote\logs）に置きます。

シークレットの保存場所 #

ワーカーが tmux の下で起動する間、リレーはそのプロバイダーのキー（OpenAI、Cursor、0.9.17 で追加 DeepSeek のキー、または Claude Cloud ワーカーや 0.9.17 で追加 Claude ワーカー用の、リレーの環境にある CLAUDE_CODE_OAUTH_TOKEN）を、システムの一時フォルダー内の自分だけが読める一時ファイルに書き込みます。ワーカーのシェルはそれを 1 回読み込んで削除します。各ワーカーが受け取るのは、自分のプロバイダーのキーだけです。

保持期間 #

リレーは次のものを自動で削除します。会話を削除しない限り、それ以外は何も削除されません。

会話を削除すると、データベースからそのメッセージ、キューのエントリ、質問、サブエージェントの記録が削除され、その会話に属する Claude のトランスクリプトと生成された画像も削除されます。0.9.17 で追加 DeepSeek の会話では、さらに data/deepseek-claude/ 内のトランスクリプト、セッションのフォルダー、停止した Claude Code が残したもの（その登録情報、フックの環境、シェルスナップショット）、ほかのセッションが使わなくなったプロジェクトフォルダーも削除し、データベースからはそのセッションが最後に報告した合計を削除します。DeepSeek カードの合計と日別の値に加算された分は残ります。各プロバイダーが自分で保持するものは、次のセクションで説明します。

状態フォルダーの外 #

0.9.14 より前は、Cursor のストアは既定でパッケージフォルダー内の server/data/cursor-agents にあり、更新でこのフォルダーが置き換えられるため、会話が保存済みのエージェントを失って新しいエージェントになることがありました（Cursor を参照）。ストアがまだその古い場所にある会話は、そこで使い続けます。両方の場所にストアがある会話は、最後に変更された方を使います。移動や削除は一切されません。

エージェントの作業、つまりプロジェクトフォルダー内のファイルは、OAR のストレージとはまったく別のところにあります。

データフォルダーごとに 1 つのリレー #

リレーは起動時にデータフォルダーに relay-server.lock を作り、停止時に削除します。このファイルには、リレーのプロセス番号、トークンのハッシュ、起動時刻が入っています。

最初のリレーの動作中に 2 つ目のリレーが同じデータフォルダーで起動すると、2 つ目は 1 行を表示して終了します。終了コードは 0.9.14 で追加 78（以前は 1）で、Linux のサービスはこれを再試行しません。

Relay already running (pid=4242, startedAt=2026-01-05T09:12:40.000Z; lock /home/dev/.oar/data/relay-server.lock). It is held by relay process 4242: oar stop, or end process 4242.

Relay already running の代わりに Relay appears to be owned by another live process と表示された場合は、実行中のリレーのトークンが異なります。ロックの保持者がリレーであると判断できない場合、ヒントは If no relay is running, end process 4242 or delete the lock. になります。oar start は The relay did not come up の後に同じヒントを表示します。最初のリレーには触れません。期待したリレーと実際に動いているリレーが違う場合、メッセージは保留のままになります。oar doctor で、使用中の設定とデータベースを確認できます。

クラッシュや電源断の後は、ロックファイルが残ります。0.9.14 で追加 最後の起動より前のロック、またはそのプロセス番号がロックより後に起動したプロセスのものになっているロックは、古いとみなされます。次の起動はそれを脇に移し、Recovered stale singleton lock とログに出してロックを引き継ぎます。この判断は時計に頼らなくなったため、時計が急に変わっても実行中のリレーが消えたように見えることはなく、同じロックを回収しようとする 2 つの起動が両方とも動くこともありません。読み取れないロック（電源断で空になったもの）は再度読み取られ、時刻が 10 秒以上ずれていない限り保持中とみなされます。oar start は、このバージョンが書き込んだロックを削除しなくなりました。以前のバージョンのロックは、リレーのポートで何も応答しない場合に引き続き削除します。

データフォルダーとポートが別々であれば、2 つのリレーを並べて実行できます。oar がリレーを見つける方法は oar コマンドを、再起動で保持されるものは再起動と再開を参照してください。