初回起動必須：データディレクトリ、ログ、トレイと自動起動

Antigravity Tools の多くの「魔法のように見える」能力（アカウントプール、クォータ、監視、統計、バックグラウンド実行）は、最終的に 2 つのものに帰着します：データディレクトリとログ。最初にこれら 2 つを明確にしておけば、後のトラブルシューティングで多くの時間を節約できます。

データディレクトリとは？

データディレクトリは Antigravity Tools がローカルマシンで状態を保存するフォルダです：アカウント JSON、クォータ関連ファイル、ログファイル、Token Stats/Proxy Monitor の SQLite データベースがここに置かれます。バックアップ/移行/トラブルシューティングを行う際、最初にこのディレクトリを特定できれば、基本的に権威あるデータソースを見つけることができます。

学習後にできること

• Antigravity Tools のデータディレクトリがどこにあるかを知る（ワンクリックで開ける）
• どのファイルをバックアップすべきか、どれがログ/キャッシュかを明確にする
• トラブルシューティングが必要な場合、ログと監視データベースを迅速に特定できる
• 「ウィンドウを閉じる」と「プログラムを終了する」の違いを理解する（トレイ常駐）
• 2 種類の自動起動を区別する：起動時自動起動 vs リバースプロキシ自動起動

現在の課題

• バックアップ/移行したいが、アカウントが実際にどこに保存されているかわからない
• UI エラー/リバースプロキシ呼び出し失敗だが、ログが見つからない
• ウィンドウを閉じ、プログラムが終了したと思っていたが、まだバックグラウンドで実行されている

いつこの方法を使用するか

• Antigravity Tools をインストールしたばかりで、「データがどこにあるか」を確認したい場合
• マシン変更/システム再インストールを準備しており、アカウントと統計データを最初にバックアップしたい場合
• OAuth 失敗、クォータ更新失敗、リバースプロキシ起動失敗、呼び出し 401/429 をトラブルシューティングする必要がある場合

🎒 開始前の準備

• Antigravity Tools をインストールし、開くことができる
• Settings ページに入れる（右上/サイドバーの設定入口）
• システムアカウントが自分の Home ディレクトリにアクセスする権限を持っている

注意

このレッスンはどのファイルが「真のデータ」かを教えますが、これらのファイルを手動で編集することは推奨しません。設定を変更する場合は、優先的に UI で変更してください。

コアアイデア

まず 1 文を覚えてください：

"データディレクトリはローカル状態の単一の真実情報源であり、ログはトラブルシューティングの最初の入り口です。"

Antigravity Tools は Home ディレクトリの下に .antigravity_tools データディレクトリを作成し、アカウント、ログ、統計ライブラリなどをそこに置きます（ディレクトリが存在しない場合は自動的に作成されます）。

同時に、デフォルトでトレイを有効にします。ウィンドウを閉じると、プログラムはすぐには終了せず、トレイに隠れてバックグラウンドで実行を続けます。

手順に従って進める

ステップ 1：設定ページでデータディレクトリを開く

なぜ まずデータディレクトリを正確に特定すれば、後でバックアップでもトラブルシューティングでも「着地点」があります。

Antigravity Tools で Settings を開き、Advanced に切り替えます。

「データディレクトリ」という読み取り専用入力ボックスが表示され（実際のパスを表示）、隣に開くボタンがあります。

開くボタンをクリックします。

次のように表示されます：システムファイルマネージャがディレクトリを開き、パスは ~/.antigravity_tools/ のようになります。

ステップ 2：データディレクトリパスを確認する（クロスシステム）

なぜ 後でバックアップスクリプトを書いたり、コマンドラインでトラブルシューティングしたりする際、システム上の実際のパスを知る必要があります。

macOS/Linux

echo "$HOME/.antigravity_tools"
ls -la "$HOME/.antigravity_tools"

Windows

$dataDir = Join-Path $HOME ".antigravity_tools"
$dataDir
Get-ChildItem -Force $dataDir

次のように表示されます：ディレクトリが存在します（初めて設定ページを開く場合、ディレクトリは自動的に作成されます）。

ステップ 3：データディレクトリ内の「重要なファイル」を認識する

なぜ すべてのファイルがバックアップに値するわけではありません。まず「アカウントデータ」「統計ライブラリ/ログ」を明確に分けます。

次のファイル名はプロジェクトソースコードから来ており、すべて固定です：

表示される内容	用途	関心を持つべきこと
accounts.json	アカウントインデックス（アカウントリスト/現在のアカウントを含む）	アカウント移行時、一緒にバックアップすることを推奨
accounts/	各アカウントごとに 1 つの *.json ファイル	これがアカウントデータの本体
logs/	アプリケーションログディレクトリ	トラブルシューティングはまずここを見る
token_stats.db	Token Stats の SQLite データベース	Token Stats ページで見るデータはここから来る
proxy_logs.db	Proxy Monitor の SQLite データベース	Monitor ページで見るリクエストログはここから来る
warmup_history.json	Smart Warmup のローカル履歴記録	主に重複 warmup を避けるために使用
update_settings.json	更新チェック設定（自動チェック/間隔など）	通常、手動で変更する必要はない

次のように表示されます：少なくとも logs/ ディレクトリがあります。まだアカウントを追加していない場合、accounts.json/accounts/ はまだ表示されない場合があります。

ステップ 4：ログの位置を記憶する（トラブルシューティングはこれに依存）

なぜ UI のエラー通知は通常「現象」しか与えず、実際の失敗原因（リクエスト失敗、ファイル読み書き失敗など）は多くの場合ログにあります。

Antigravity Tools はデータディレクトリの下の logs/ にログを書き込みます。

macOS/Linux

ls -la "$HOME/.antigravity_tools/logs"

Windows

Get-ChildItem -Force (Join-Path $HOME ".antigravity_tools\logs")

次のように表示されます：ディレクトリの下に日付ごとのローテーションログファイル（ファイル名は app.log で始まる）が存在します。

ステップ 5：「ログをクリア」する必要がある場合、設定ページのワンクリッククリアを使用する

なぜ 一部の問題は一度だけ再現し、その時のログを単独で残したい場合、最初にログをクリアすると比較しやすくなります。

Settings -> Advanced でログ領域を見つけ、「Clear Logs」をクリックします。

次のように表示されます：確認ボックスが表示されます。確認後、クリア成功が通知されます。

心配する 2 つのこと

• ログは自動的に「日次ローテーション」を行い、起動時に 7 日を超える古いログをクリアしようとします。
• 「Clear Logs」はログファイルを 0 バイトに切り詰め、実行中のプロセスが同じファイルハンドルに書き続けられるようにします。

ステップ 6：「ウィンドウを閉じる」と「プログラムを終了する」の違いを明確にする（トレイ）

なぜ Antigravity Tools はデフォルトでトレイを有効にします。ウィンドウ右上の閉じるをクリックすると、プログラムはトレイに隠れて実行を続けます。終了したと思っていると、「ポートまだ占用中/バックグラウンドまだ実行中」の錯覚が起こりやすくなります。

この小さなフローで確認できます：

操作：ウィンドウを閉じる（終了ではない）

┌─────────────────────────────────────────────────────────────┐
│  ステップ 1                ステップ 2                             │
│  ウィンドウ閉じる       →   システムトレイ/メニューバーでアイコンを探す              │
└─────────────────────────────────────────────────────────────┘

次のように表示されます：トレイアイコンがまだ存在し、クリックするとウィンドウを再表示できます。

トレイメニューには他にも 2 つのよく使うアクションがあります（UI を通さない場合に便利）：

• アカウント切り替え：次のアカウントに切り替える
• クォータ更新：現在のアカウントクォータを更新（同時にフロントエンド表示更新を通知）

ステップ 7：起動時自動起動を設定する（起動後自動最小化）

なぜ 「常駐サービス」のように動作させたい場合（トレイ常駐 + バックグラウンド更新）、起動時自動起動は毎回手動で開く手間を省けます。

Settings -> General で「Auto Launch on Startup」を見つけ、有効にします。

次のように表示されます：切り替え後、有効成功が通知されます。次回起動時、--minimized パラメータを付けて実行されます。

2 種類の「自動起動」、混同しないでください

名称	指すもの	証拠
起動時自動起動	コンピュータ起動後、Antigravity Tools を自動起動（デスクトップアプリ自体）	起動パラメータに --minimized が含まれ、toggle_auto_launch コマンドを提供
リバースプロキシ自動起動	Antigravity Tools 起動後、proxy.auto_start=true を設定すると、自動的にローカルリバースプロキシサービスを起動しようとする	アプリ起動時に設定を読み取り、start_proxy_service(...)

チェックポイント ✅

• [ ] Settings -> Advanced でデータディレクトリの実際のパスが見えます
• [ ] データディレクトリを開き、accounts.json、accounts/、logs/、token_stats.db、proxy_logs.db を大まかに認識できます
• [ ] ログが logs/ にあることを知り、コマンドラインで素早く見ることができます
• [ ] ウィンドウを閉じた後もプログラムがトレイで実行中であることを知り、終了するにはトレイの Quit を使用することを知っています
• [ ] 「起動時自動起動」と「リバースプロキシ自動起動」を区別できます

トラブルシューティング

シナリオ	間違ったやり方（❌）	推奨されるやり方（✓）
データディレクトリが見つからない	システム内で App のインストールディレクトリを無秩序に検索する	直接 Settings -> Advanced で「データディレクトリ」を確認し、ワンクリックで開く
ウィンドウを閉じて終了したと思った	ウィンドウを閉じた後、設定を変更/ポートを変更する	最初にトレイアイコンがまだ存在するか確認する。終了するにはトレイの Quit を使用する
ログが多すぎてトラブルシューティングできない	問題を再現しながら古いログをめくる	最初に「Clear Logs」を実行し、再び 1 回再現し、最後に今回のログファイルのみを見る
アカウントデータを変更したい	accounts/*.json を手動で編集する	UI のインポート/エクスポート/移行フローを使用する（次の関連セクションで説明）

このレッスンのまとめ

• データディレクトリは Home の下の .antigravity_tools に固定されます（macOS/Linux では通常非表示ディレクトリ）、アカウント/ログ/統計ライブラリはすべてここにあります
• ログディレクトリは logs/ で、トラブルシューティングはまずここを見る。必要に応じて設定ページでワンクリッククリアできます
• ウィンドウを閉じるとトレイに隠れて実行を続ける。完全に終了するにはトレイの Quit を使用する
• 自動起動には 2 種類あります：起動時自動起動（アプリ）とリバースプロキシ自動起動（Proxy）

---

次のレッスン予告

次のレッスンでは、アカウント追加：OAuth/Refresh Token デュアルチャンネルとベストプラクティス を学びます。

---

付録：ソースコード参照

クリックしてソースコードの場所を表示

更新日時：2026-01-23

機能	ファイルパス	行番号
データディレクトリの位置（~/.antigravity_tools）	src-tauri/src/modules/account.rs	16-33
アカウントインデックスとアカウントファイルディレクトリ（accounts.json / accounts/）	src-tauri/src/modules/account.rs	16-46
ログディレクトリと日次ローテーション（logs/ + app.log）	src-tauri/src/modules/logger.rs	17-83
ログのクリア（ファイル切り詰め）	src-tauri/src/modules/logger.rs	149-169
設定ページでデータディレクトリを表示 + ワンクリックで開く	src/pages/Settings.tsx	525-576
設定ページでワンクリックログクリア（ボタン + ダイアログロジック）	src/pages/Settings.tsx	127-135
設定ページでワンクリックログクリア（Advanced タブボタン）	src/pages/Settings.tsx	732-747
トレイメニューとクリックイベント（アカウント切り替え/更新/表示/終了）	src-tauri/src/modules/tray.rs	9-158
---	---	---
---	---	---
起動時自動起動スイッチ（toggle_auto_launch / is_auto_launch_enabled）	src-tauri/src/commands/autostart.rs	4-39
データディレクトリをワンクリックで開く / パスを取得 / ログクリアコマンド	src-tauri/src/commands/mod.rs	578-621
Token Stats データベースファイル名（token_stats.db）	src-tauri/src/modules/token_stats.rs	58-61
Proxy Monitor データベースファイル名（proxy_logs.db）	src-tauri/src/modules/proxy_db.rs	5-8
Warmup 履歴ファイル名（warmup_history.json）	src-tauri/src/modules/scheduler.rs	14-17
更新設定ファイル名（update_settings.json）	src-tauri/src/modules/update_checker.rs	150-177
リバースプロキシ自動起動（proxy.auto_start=true 時にサービスを起動）	src-tauri/src/lib.rs	107-126

次のレッスン予告

次のレッスンでは、アカウント追加：OAuth/Refresh Token デュアルチャンネルとベストプラクティス を学びます。

学びます：

• いつ OAuth を使用し、いつ refresh_token を直接使用するか
• コールバック失敗と refresh_token が取得できない場合の対処方法
• refresh_token を一括インポートしてアカウントプールを迅速に構築する方法