CLI · 第3層
ツール
AIエージェント、ワークベンチ、およびデバッグ用のユーティリティを提供します — search, replace, inspect, doctor, upgrade, skills:sync。これらは実装済みのコマンドですが、日々のビルドサイクルの一部ではありません。
第3層の CLI ツールは、ワークスペースの操作、構造検査、およびステータスの更新をサポートします。これらのツールは、日々のビルドのライフサイクルとは独立しています。
ソースコード操作
MDX ソースに対してフルテキスト検索を実行します。一致するアイテムのファイルパス、行番号、列、およびプレビュー文字列を返します。
open-press search . <query> [--json]パラメータ (Flags)
| Name | Type | Default | Description |
|---|---|---|---|
<query> required | string | 検索ターゲット。プレーンテキストまたは正規表現をサポートします。 | |
--json | flag | 機械可読な JSON 形式で出力します。 | |
--scope | string | "content" | 検索範囲を指定します。`content` (MDX 本文のみ) または `all` (フロントマターとメタデータを含む)。 |
--case-sensitive | flag | 大文字と小文字を区別します。デフォルトでは区別しません。 |
例：JSON 検索
open-press search . "Figure" --json | jq '.matches[] | {file: .path, line, preview}'MDX ソースに対して一括文字列置換操作を実行します。デフォルトモードは読み取り専用のプレビューです。
open-press replace . <from> <to> [--apply]パラメータ (Flags)
| Name | Type | Default | Description |
|---|---|---|---|
<from> required | string | 検索ターゲット文字列または正規表現。 | |
<to> required | string | 置換用文字列。 | |
--apply | flag | 変更を適用し、ファイルに書き込みます。このフラグが指定されていない場合はプレビューのみを出力します。 | |
--scope | string | "content" | `search` コマンドのスコープ設定と同じです。 |
--include-code | flag | 置換範囲をコードブロック (fenced code blocks) に拡大します。コードの誤変更を防ぐため、デフォルトではスキップされます。 | |
--case-sensitive | flag | 大文字と小文字を区別します。 | |
--json | flag | 機械可読な JSON レポートを出力します。 |
例：置換の実行
open-press replace . "古いフレーズ" "新しいフレーズ" --applyレンダリング検査
ビルド後のイントロスペクションを実行します。ヘッドレス Chrome を呼び出して、ビルド済みプロジェクトのブロックジオメトリ寸法とアノテーションマークを分析します。
open-press inspect . [--json]パラメータ (Flags)
| Name | Type | Default | Description |
|---|---|---|---|
--json | flag | 機械可読な JSON レポートを出力します。 | |
--no-build | flag | ビルドフェーズをバイパスし、既存の `dist-react/` ディレクトリを分析します。 | |
--host | string | "127.0.0.1" | ヘッドレス Chrome が接続するサーバーの IP。 |
--port | string | "5186" | ヘッドレス Chrome が接続するサーバーのポート。 |
--dry-run | flag | 実行チェーンコマンドのみを出力し、サーバーの起動や Chrome の呼び出しは行いません。 |
環境と状態の管理
ワークスペースの依存関係とパッケージのバージョン状態を報告します。フレームワークのバージョンとエージェントスキルを確認します。結果は24時間キャッシュされます。
open-press doctor .パラメータ (Flags)
| Name | Type | Default | Description |
|---|---|---|---|
--json | flag | 機械可読な JSON レポートを出力します。 | |
--no-cache | flag | ローカルキャッシュをバイパスし、最新情報を npm に直接クエリします。 |
doctor コマンドの終了コードは常に 0 です。自動化プロセスは、JSON 出力の report.stale または report.coreUpdateAvailable を解析して実行ロジックを決定する必要があります。
ワークスペースの依存関係とエージェントスキルをアップグレードします。source migration と QA には `openpress-upgrade` skill を使用します。
open-press upgrade .doctor と組み合わせて使用し、実行前に Git のバージョン管理スナップショットが作成されていることを確認してください。このコマンドはパッケージと skills を更新します。workspace source migration は agent が担当します: openpress-upgrade を使用して適用対象の migration docs を読み、press/ をスキャンし、確認済みの source edits を適用し、Migration QA checkpoints をループします。
スキルパッケージを .agents/skills/ ディレクトリおよび関連するプラットフォームミラーに同期します。skills-lock.json に基づいて更新を実行します。
open-press skills:sync .パラメータ (Flags)
| Name | Type | Default | Description |
|---|---|---|---|
--source | string | 指定されたスキルパッケージを追加してインストールします。フォーマット：`owner/repo` または `github:owner/repo`。 | |
--dry-run | flag | 基盤となる `npx skills` コマンドを出力するだけで、インストールは実行しません。 |