nativewright は何をしますか？
AIエージェントがCLIコマンドで永続的なChromeブラウザを制御し、ログイン状態を維持します。
概要
nativewright は、AIエージェント（Claude Code、Cursor、Codexなど）がCLIコマンドを使用してChromeブラウザの永続インスタンスを操作できるようにするツールです。Playwrightをベースに構築されており、ブラウザの起動、ページナビゲーション、要素とのインタラクション、スクリーンショットの取得などを簡単に行えます。
主な機能
- 永続ブラウザ: ブラウザセッションは再起動後も維持され、ログイン状態を保持します。
- CLI制御: AIエージェントはシンプルなCLIコマンドでブラウザを操作できます。
- Playwrightベース: 信頼性の高いブラウザ自動化を実現。
- ログイン状態の維持: 認証が必要なワークフローに最適。
使用方法
# ブラウザを起動
npx nativewright launch
# URLに移動
npx nativewright goto https://example.com
# 要素をクリック
npx nativewright click "button#submit"
# テキストを入力
npx nativewright fill "input#search" "検索クエリ"
# スクリーンショットを取得
npx nativewright screenshot screenshot.png
# JavaScriptを実行
npx nativewright eval "document.title"
設定
環境変数または設定ファイルでブラウザの動作をカスタマイズできます。
| 環境変数 | 説明 | デフォルト値 |
|---|---|---|
BROWSER_DATA_DIR | ブラウザデータディレクトリ | ./browser-data |
BROWSER_HEADLESS | ヘッドレスモード | false |
BROWSER_PORT | デバッグポート | 9222 |
対応プラットフォーム
- Claude Code
- Cursor
- Codex
- その他CLI対応AIエージェント
インストール
npm install -g nativewright
# または
npx nativewright
例
# ブラウザを起動してGoogleに移動
npx nativewright launch
google
# 検索を実行
npx nativewright fill "textarea[name='q']" "AIエージェント"
npx nativewright press Enter
# 結果をスクリーンショット
npx nativewright screenshot google_search_results.png
ライセンス
MIT