CLI リファレンス#

ovellum <subcommand> [flags]

npx ovellum で実行するか、インストール後にパッケージのバイナリとして実行するか、 あるいはパッケージマネージャーのタスクランナー経由で実行します。

サブコマンド#

ovellum init#

カレント（または指定した）ディレクトリに新しいプロジェクトを生成します。 --force を渡さない限り、既存の ovellum.config.json を上書きすることはありません。

構文#

ovellum init [--cwd <dir>] [--yes] [--force]

フラグ#

プロンプト（対話モード）#

1. Project name — package.json#name またはフォルダ名がデフォルトです。
2. Mode — manual（デフォルト）、auto、または hybrid。
3. Site title — プロジェクト名をタイトルケースにしたものがデフォルトです。
4. Description — <meta name="description"> に使用されます。
5. （manual）Content dir / Output dir / Generate landing page?
6. （auto / hybrid）tsconfig / Output dir。
7. Default theme — auto、light、または dark。

出力#

すでに存在しないファイルのみを書き込みます（--force を指定しない限り）。

• ovellum.config.json
• <input>/index.md（manual + hybrid モードのみ）。親しみやすいスターター付き。
• AGENTS.md — AI コーディングエージェント向けの、モードに応じた指示（保護ゾーンの契約 + コマンド）。自動化を参照。既存の AGENTS.md がある 場合は、標準の「Ovellum docs」セクションだけを追加または更新します — ovellum agents と同じ動作です。
• .gitignore — 未記載の場合に <output>/ と .orphans/ を追記します。

選択したモードに応じた番号付きの次のステップ一覧を表示します。

終了コード#

ovellum build#

プロジェクトの ovellum.config.* を解決し、設定済みのパイプラインを実行し、 出力をディスクに書き込み、サマリーを表示します。

構文#

ovellum build [--cwd <dir>] [--config <path>] [--drafts] [--out <dir>] [--base <path>] [--manifest]

フラグ#

モードごとの挙動#

auto#

1. input/ を解析して DocProject IR にします。
2. IR を Markdown にレンダリングします。
3. 既存ファイルを上書きしながら各出力を書き込みます。

hybrid（デフォルト）#

auto と同じ処理の後、生成された各ファイルについて次を行います。

1. 既存の出力ファイルがあれば読み込みます。
2. <!-- @manual:start --> ブロックを含む場合は、マージャーを実行します。
3. アンカーがもう存在しないブロックは protect.orphanDir に書き出されます。

manual#

1. input/ を走査して .md ファイルを探します。
2. それぞれを HTML にレンダリングします（Markdown はサニタイズされます。セキュリティを参照）。
3. サイドバーナビゲーションとパンくずリストを構築します。
4. 各ページをデフォルトテンプレートで囲みます（トップバー、サイドバー、目次、前後リンク、ページメタ）。
5. プリティ URL を output/ に書き込みます。
6. バンドルされたテンプレートから assets/ovellum.css と assets/ovellum.js をコピーします。
7. site.baseUrl が設定されている場合は sitemap.xml と feed.xml を出力します。
8. site.search.enabled が true の場合は、出力に対して Pagefind を実行し dist/pagefind/ を出力します。
9. AI フレンドリーな出力を出力します — llms.txt、各ページの .md ミラー（有効なら llms-full.txt も）。デフォルトでオン。site.ai で制御します。

サマリー出力#

Auto / hybrid#

ovellum build complete in 207ms
  config:    .../ovellum.config.json
  mode:      hybrid
  sources:   2          ← input files parsed
  written:   2 file(s)  ← Markdown files written
  merged:    1 file(s)  ← hybrid only: files where a manual block was spliced
  orphans:   0          ← hybrid only: blocks whose anchor disappeared
  warnings:  0          ← 対処すべき実際の問題（severity "warning"）
  notes:     1          ← 良性の通知（severity "info"）。> 0 のときのみ表示
    → docs/format.md
    → docs/user.md
  quarantined:          ← only printed when orphans > 0
    ↪ .ovellum/orphans/2026-05-15_src-format.ts-padZero.md
  ir:        .ovellum/ir.json   ← parsed IR snapshot, written every auto/hybrid build

診断は severity で分けられます。warnings: は実際の問題（孤立したコンテンツ、 安全のためスキップされたアセット、解析できない日付）を数え、notes: は良性の通知 （ドラフトの除外、site.baseUrl 未設定による sitemap.xml のスキップ）を数えます。 サマリーの下では、それぞれ warning: / info: の行として — 実際の問題を先頭に — 表示されるので、埋もれることはありません。--json も同じ { message, severity } の形を持ちます（自動化を参照）。

auto/hybrid ビルドは毎回、解析した IR をプロジェクトルートの .ovellum/ir.json （.ovellum/orphans/ の隣）にも書き出します — 直前に読み取ったシンボル・アンカー・ シグネチャのスナップショットです。これはデプロイ成果物ではなくビルド 状態 なので、 --out に関係なくプロジェクトルートに残り、.ovellum/ はデフォルトの雛形で gitignore されています。今後のソース差分・リネーム検出・アンカーの最終確認追跡の基盤であり、 API サーフェスの構造化ビューを必要とするツールから自分で読み取ることもできます。

Manual#

ovellum build complete in 207ms
  config:    .../ovellum.config.json
  mode:      manual
  output:    dist/
  pages:     5
  warnings:  0
    → /                       (dist/index.html)
    → /configuration/         (dist/configuration/index.html)
    → /getting-started/       (dist/getting-started/index.html)
    → /guides/deploying/      (dist/guides/deploying/index.html)
    → /guides/theming/        (dist/guides/theming/index.html)
  manifest:  dist/.ovellum/manifest.json   ← --manifest 指定時のみ

終了コード#

stderr には警告ごとの行（warning: …）が出力されます。stdout にはサマリーが出力されます。

例#

# Build from the current directory
npx ovellum build

# Build a different project
npx ovellum build --cwd ./website

# Bypass config discovery
npx ovellum build --config ./config/ovellum.prod.ts

# Deploy-anywhere: build into a repo's /docs folder with a deploy manifest
npx ovellum build --out ./docs --base /docs --manifest

ovellum diff#

現在のソースを、直前のビルドが書き出した IR スナップショット （.ovellum/ir.json）と比較し、再ビルドで何が変わるか — 追加・削除・変更された シンボルと、それらが触れる出力ドキュメント — を報告します。何も書き込みません。 ビルドではなくプレビューです。auto/hybrid 専用です（manual ビルドはソースを解析せず IR を持ちません）。

シンボルは安定したアンカー id で照合します。アンカーが消え、似たシンボル（同じ種別・ 似た名前・同じシグネチャ形状）が現れた場合、その 2 つは無関係な削除＋追加ではなく リネームの可能性が高いペアとして扱われます — リファクタリング後に対応すべき提案です。 行番号がずれるだけの表面的な編集は無視され、ドキュメント化された面（シグネチャ・引数・ 戻り値・説明・非推奨・JSDoc タグ・エクスポート/可視性）が実際に異なるときだけ変更として 報告されます。

構文#

ovellum diff [--cwd <dir>] [--config <path>] [--json] [--exit-code]

フラグ#

出力#

ovellum diff — current source vs .ovellum/ir.json (built 2026-06-24T17:58:46.322Z)

  + 1 added   - 0 removed   ~ 1 changed   → 1 renamed

likely renames:
  → src/date.ts::formatDate → src/date.ts::formatDateUTC  (97%)

added:
  + src/math.ts::mul  (function)

changed:
  ~ src/math.ts::add  (function)  signature, params

docs that would change:
  ~ docs/math.md  (+1 ~1 -0)

差分がない場合:

ovellum diff — no changes since the last build (.ovellum/ir.json, <timestamp>).

終了コード#

例#

# See what a rebuild would change
npx ovellum build           # records the baseline snapshot
# ...edit source...
npx ovellum diff            # preview the impact

# Fail CI if docs would drift from source
npx ovellum diff --exit-code

ovellum dev#

ビルド + 監視 + 配信 + ライブリロードを組み合わせたループです。 執筆中に走らせておきたい 1 つのコマンドです。

構文#

ovellum dev [--cwd <dir>] [--config <path>] [--port <n>] [--host <addr>] [--no-drafts] [--verbose]

フラグ#

挙動#

1. 設定を読み込み、config.output（ビルドの dist/ ディレクトリ）を解決します。
2. --host:--port にバインドした HTTP サーバーを起動します。
3. 初回ビルドを実行し、その後 input/ と設定ファイルの変更を監視します （ovellum watch と同じ 300 ms のデバウンス）。
4. ビルドが成功するたびに、接続中のすべてのブラウザタブに Server-Sent Events で reload イベントを送ります。注入されたクライアントスクリプトが location.reload() を呼び出します。
5. Ctrl-C でウォッチャーとサーバーの両方をクリーンに停止します。

注入されるリロードスクリプトは、HTML レスポンスに対してのみ、かつ dev が 実行中のコマンドである場合にのみ追加されます。ovellum build の出力が変更されることはありません。

出力#

ovellum dev starting from .../ovellum.config.json
built 17 page(s) in 720ms

watching content for changes…
local:   http://127.0.0.1:3000/
press Ctrl-C to exit.

保存後:

changed: content/getting-started.md
built 17 page(s) in 60ms

終了コード#

例#

# Default: localhost:3000
npx ovellum dev

# Pick a port
npx ovellum dev --port 4000

# Expose to the LAN (useful for mobile testing)
npx ovellum dev --host 0.0.0.0

# Multi-site monorepo
npx ovellum dev --cwd ./website

ovellum serve#

監視を行わない純粋な静的ファイルサーバーです。本番ビルドを実際の配信時と まったく同じ形でプレビューしたい場合や、再ビルドを別の場所で扱う プロセスマネージャーに組み込む場合に便利です。

構文#

ovellum serve [--cwd <dir>] [--config <path>] [--port <n>] [--host <addr>]

フラグは ovellum dev と同一です。サーバーは config.output から読み込みます。 そのディレクトリが存在しない場合、serve は 1 で終了し、ovellum build または ovellum dev を案内します。

ovellum dev との違い#

サーバーだけが必要な場合（例えば別のシェルで自分で ovellum watch を 動かしている場合）は、serve が適切なコマンドです。

ovellum check#

検証のみのパスで、書き込みは行いません。設定を読み込み、input/ 配下の すべての .md ファイルを走査し、remark でリンクを抽出した上で（フェンス付き コードブロックは正しく無視されます）、次を検証します。

1. すべての内部リンクが、サイドバーナビゲーション内の実在するページ URL に解決されること。
2. 安全でない URL スキーム（javascript:、vbscript:、data:、file:）を 使うリンクがないこと。renderMarkdown がレンダリング時にこれらを除去するとはいえ、 check はここで警告し、作者がソースの段階で削除できるようにします。
3. すべての ::include ターゲットが存在すること （ビルドと同じ解決順: ページのロケールツリー、次にデフォルトロケール）、そして コンテンツディレクトリの内側に留まること。
4. i18n サイト（site.locales が 2 つ以上）では、翻訳がそのソースページと 同期していること — 翻訳の陳腐化を参照してください。

構文#

ovellum check [--cwd <dir>] [--config <path>] [--update-translations] [--json] [--strict]

フラグ#

strict モード（--strict）#

--strict はデフォルトに加えて 3 つのオプトイン検証を追加します:

• 位置依存の保護ゾーン — id= のない <!-- @manual:start -->。id のない ゾーンは位置で照合されるため、並べ替えで失われる可能性があります。id="..." を 付けてください。（hybrid / auto）
• 古いアンカー — 生成ドキュメント内の <!-- ovellum:anchor id="…" --> で、 そのシンボルがソースにもう存在しないもの（削除、または再ビルドされていないリネーム）。 再ビルドするか、文章を再アタッチしてください。（hybrid / auto）
• タイトルのないページ — フロントマターの title: も先頭の # 見出し もない ページで、実質的なタイトルがありません。（manual）

strict の問題は出力で [STRICT] とタグ付けされ、strict issues:（--json では counts.strictIssues）に計上されます。

出力#

問題なし:

ovellum check complete in 76ms
  config:    .../ovellum.config.json
  mode:      manual
  pages:     14
  broken links:    0
  unsafe schemes:  0

問題あり:

ovellum check complete in 87ms
  config:    .../ovellum.config.json
  mode:      manual
  pages:     14
  broken links:    1
  unsafe schemes:  1
  details:
    content/getting-started.md:42   [SECURITY] unsafe URL scheme 'javascript:' — link will be stripped by the HTML sanitizer (raw: javascript:alert(1))
    content/getting-started.md:112  broken internal link to /no/such/page/ (raw: /no/such/page/)

終了コード#

• 0 問題なし
• 1 1 件以上の問題が見つかった
• 3 設定が不正

モードごとの挙動#

Manual モード — input/ を走査して .md ファイルを探し、すべての内部リンクを サイドバーナビゲーションに対して検証します。i18n サイトでは、これはロケールごとに 実行されます。各 content/<code>/ サブツリーがそれぞれのロケールプレフィックス付きの ナビを構築し、リンクは全ロケールの URL の和集合に対して検証されます — そのため /ja/… リンク、デフォルトロケールへのロケール横断 /docs/… リンク、相対リンクが すべて正しく解決されます。

Hybrid / auto モード — 出力ディレクトリ（自動生成された Markdown）を走査し、 すべての内部リンクをディスク上の実ファイルに対して検証し、安全でない URL スキームも 同じように警告します。出力ディレクトリが存在しない場合、check は 1 で終了し、 まず ovellum build を実行するよう案内します。

タイトルのチェックや id なし / 古いアンカーの検証は --strictで利用できます。孤立の一覧は ovellum orphansにあります。

翻訳の陳腐化#

site.locales が 2 つ以上あるサイトでは、check は各翻訳ページが、それがミラーする デフォルトロケールのページ（ロケールフォルダをまたいで同一のパスで対応）と同期して いることも検証します。各翻訳はフロントマターに sourceHash を持ちます — ソースページの 本文の指紋です（フロントマターは除外、改行コードは正規化）。check はこれを再計算し、 [i18n] タグを付けて報告します:

• スタンプ後にソースが変わった翻訳（stale）。
• sourceHash がない翻訳（未スタンプ）。
• 対応するソースページがない翻訳（orphan）。

いずれも issue として数えられるため、check は 1 で終了します — CI がドリフトを 検知できます。翻訳を同期させた後にハッシュをスタンプ（または再スタンプ）するには、次を 実行します:

ovellum check --update-translations

各翻訳ページに現在の sourceHash を書き込み（変更するのはそのフロントマター 1 行だけ）、 0 で終了します。ワークフローは i18n ガイド を参照してください。

ovellum watch#

ビルド後、input/（と設定ファイル）の変更を監視し、変更のたびに再ビルドします。 部分的な書き込みが中途半端な状態での再ビルドを引き起こさないよう、chokidar の awaitWriteFinish を有効にした上で 300 ms でデバウンスされます。すべてのモード （manual、hybrid、auto）で動作します。ウォッチャーが適切なビルドパスへ自動的に ディスパッチします。

よくある「再ビルド + 配信 + 自動リフレッシュ」のループ（manual モード）には、 ほぼ確実に ovellum dev の方が適しています。watch はその基礎部品で、 別のサーバー（CDN エミュレーター、リバースプロキシ、自前のプロセスマネージャー）を 動かしたい場合や、ビルド通知をどこかに流したい場合、あるいは auto / hybrid モード （ライブリロードする HTML がなく、再生成された Markdown のみ）の場合に役立ちます。

構文#

ovellum watch [--cwd <dir>] [--config <path>]

挙動#

• 起動時に初回ビルドが一度実行されます。
• input/ 配下のいずれかのファイルの変更で、同じパイプラインが再トリガーされます。
• インクリメンタル再ビルド（auto / hybrid）。 初回ビルド後、ウォッチャーはパーサーを ウォームに保ち、変更したファイルだけを再解析し、内容が実際に変わったドキュメントだけを 再ビルドします — 大きなコードベースで大幅に高速です。永続化された IR スナップショットは引き続きプロジェクト全体を反映し、hybrid の 保護ゾーンはフルビルドと同じように保持されます。（manual モードは従来どおりサイト全体を 再ビルドします。）
• 設定ファイル自体の変更があった場合は、次のビルドの前に再読み込みします （include/exclude グロブが変わった可能性があるため、ウォームパーサーもリセットします）。
• Ctrl-C でウォッチャーをクリーンに停止します。

HTTP サーバーもライブリロードもありません。別のターミナルで ovellum serve と 組み合わせるか、お好みの別の静的サーバーを利用してください。

ovellum upgrade#

npm レジストリに新しく公開された ovellum がないか確認し、インストールします。 このコマンドは Ovellum がどのようにインストールされたか（グローバルかローカルの devDependency か、どのパッケージマネージャーか）を検出し、対応するインストール コマンドを実行します。

このコマンドはプロジェクトのローカル依存を優先します。カレントディレクトリの package.json が ovellum を宣言している（または既に node_modules にある）場合、 グローバルバイナリで呼び出してもプロジェクト（… add -D ovellum@latest）を対象にし、 パッケージマネージャーはプロジェクトのロックファイルから読み取ります。そうした プロジェクトの外にいるときだけグローバルインストールにフォールバックします。表示される 行に対象が示されます。例: Update available: 0.10.0 → 0.10.1 (this project's local dependency).

構文#

ovellum upgrade [--dry-run] [--yes]

フラグ#

挙動#

• すでに最新バージョンの場合は、その旨を表示して 0 で終了します。
• そうでない場合は current → latest と正確なインストールコマンドを表示します。
• 対話モードでは実行前に確認します（デフォルトは yes）。--yes では確認なしで 実行し、--dry-run では表示のみ行います。
• --yes なしの非対話シェル（TTY なし）では、コマンドを表示するだけで 実行せずに終了します。CI やスクリプト内で環境を黙って変更することは決してありません。
• インストールは出力を継承したサブプロセスで実行されます。ovellum upgrade は そのプロセスの終了コードで終了します。

更新通知#

このコマンドとは独立して、Ovellum は新しいバージョンが存在する場合、コマンドの 完了後に 1 行の 「update available」 通知を表示します。これはあくまで案内であり、 ovellum upgrade なしに何かがインストールされることはありません。このチェックは:

• update.intervalHours（デフォルト 24h）あたり最大 1 回だけ npm にアクセスします。 結果はキャッシュされるため、ほとんどの実行ではネットワーク I/O は発生しません。
• CI、非対話シェル、NO_UPDATE_NOTIFIER が設定されている場合、--no-update-check が 渡された場合、そして update.check が false の場合は 無効になります。
• コマンドを遅延させたり失敗させたりすることは決してありません。あらゆるエラー経路は握りつぶされます。

ovellum orphans#

protect.orphanDir（デフォルト .ovellum/orphans/）配下の隔離された手動ブロックを一覧表示します。hybrid ビルド中に 保護された @manual ブロックのアンカーが消えると、その文章は失われる代わりにここへ 移されます。ovellum orphans は溜まったものを確認するためのコマンドです。読み取り専用で、 何も書き込みません。

各孤立について、アンカー id、それが存在していたドキュメント、孤立した日時（および経過日数）、 アンカーを最後に見たビルド、そして — IR スナップショットがある場合は — そのアンカーがソースに戻っている（手作業で再アタッチできる）か消えたままかを表示します。

構文#

ovellum orphans [--cwd <dir>] [--config <path>] [--stale] [--json] [--reattach]

フラグ#

出力#

ovellum orphans — 1 orphan in .ovellum/orphans/

  src/math.ts::add
    orphaned:   2026-06-24T18:25:19.412Z (today)
    last seen:  2026-06-24T18:25:18.992Z
    doc:        docs/math.md
    block id:   why
    anchor:     gone from current source
    file:       .ovellum/orphans/2026-06-24_src-math.ts-add.md

再アタッチ（--reattach）#

ovellum orphans --reattach はアーカイブを 1 件ずつ巡回し、各孤立について次を行えます:

• 提案されたアンカーへ 再アタッチ します — シンボルがソースに戻っていれば同じアンカー、 リネームされた可能性が高ければ名前が近いアンカー（別のアンカー id を入力することもできます）。 文章はそのアンカーの下の @manual 保護ゾーンに書き込まれるので次回のビルドでも保持され、 アーカイブファイルは削除されます。
• 孤立を 削除（確認あり）、または スキップ します。

現在のアンカーは直前のビルドの IR スナップショットから読み取るため、先に ovellum build を実行してください。再アタッチ先はビルド済みドキュメントなので、変更は再ビルドが 保持するのとまったく同じ場所に入ります。

終了コード#

ovellum mcp#

Ovellum を Model Context Protocol サーバーとして stdio 上で起動し、AI エージェントが第一級のツールとして操作できるようにします。stdin/stdout で改行区切りの JSON-RPC を話します — 任意の MCP クライアントを ovellum mcp に向ければ、 下記のツールが検出されます。（追加の依存はありません。サーバーは CLI に組み込まれています。）

構文#

ovellum mcp [--cwd <dir>]

--cwd はツールが操作するプロジェクトのルートを指定します（デフォルトはカレント ディレクトリ）。stdout はプロトコルのチャネルです — それ以外のものを流し込まないでください。

ツール#

ovellum_write_zone は、他のどんなドキュメントサーバーも提供できないものです。エージェントが 手書きの文章を寄与し、それが次回のビルドで上書きされる代わりに再生成を生き延びます。生存には hybrid モードが必要です。auto モードではブロックは書き込まれますが、 次回のビルドで上書きされます。

IR ベースのツールはスナップショットを必要とします — 先にビルドを実行してください（または ovellum_build を呼んでください）。そうすれば .ovellum/ir.json が存在します。

リソース#

ツールに加えて、サーバーは Ovellum の読み取り面を MCP リソースとして公開します — エージェントが直接取り込めるコンテキストです:

プロンプト#

そして、厳選されたプロンプト（クライアントが提示する誘導ワークフロー）:

例（Claude Code）#

claude mcp add ovellum -- npx ovellum mcp --cwd /path/to/project

ovellum clean#

手で書いたものはすべて保持しつつ、生成された出力を削除します。デフォルトは ドライラン — 何を削除するかを一覧表示するだけです。実際に削除するには --confirm を渡します。

ovellum clean [--cwd <dir>] [--config <path>] [--confirm] [--orphans]

モードごとに削除するもの:

• manual — 出力ディレクトリ全体（デフォルトは dist/）。これはコンテンツから 100% 生成されるので、input 内の .md ソースには手を触れません。
• auto / hybrid — 生成された Markdown ファイル。ジェネレーターが書き込む ovellum: true フロントマターで識別します。常に保持されるものが 2 つあります: 手で書いたファイル（ovellum: true がない）と、@manual ゾーンを含む生成ファイル — その文章はファイル内にしか存在しないので、clean は決して削除しません。

.ovellum/orphans/ はデフォルトで保持します（コミット済みの手書きの文章）。 孤立アーカイブも削除するには --orphans を渡します。手書きの文章の削除は意図的で なければならないため、明示的なフラグなしには決して起きません。

ovellum snapshot#

現在のドキュメントをバージョンとして凍結します: 最新のコンテンツツリーを <input>/<id>/ にコピーし、追加すべき site.versions エントリを表示します。このコマンドが設定を編集することはありません — TypeScript の設定は機械編集が安全にできないため、設定変更は常にあなたが レビューして行います。

• バージョン管理済みのプロジェクトでは、ソースは最新バージョンの ディレクトリです（content/<latest>/ → content/<id>/）。兄弟バージョンには 触れません。
• site.versions のないプロジェクトでは、ソースはコンテンツルートです （新しいバージョンディレクトリ自体と、内側にネストした出力ディレクトリは スキップ）。出力が一度きりの移行手順を説明します: site.versions を設定すると、 最新を含むすべてのバージョンが独自のディレクトリを持ちます。

シノプシス#

ovellum snapshot <id> [--cwd <dir>] [--config <path>] [--force]

フラグ#

終了コード#

ovellum agents#

プロジェクトのトップレベルのエージェント指示ファイル — AGENTS.md および/または CLAUDE.md — に、標準の**「Ovellum docs」セクション**を追加または更新します。 このセクションは、このリポジトリでのドキュメントの仕組みをあらゆるコーディング エージェントに伝えます: どのディレクトリが再生成されるか、保護ゾーンの契約 （hybrid）、実行すべきコマンドとその終了コード、MCP サーバーの場所。内容は設定 （mode、input、output、protect.orphanDir）からレンダリングされるので、 プロジェクトの構成が変わっても正確なままです。

このコマンドは冪等かつ外科的です:

• プロジェクトルートに存在する AGENTS.md / CLAUDE.md を更新します — 両方が 存在すれば両方。どちらもなければ、セクションだけを含む AGENTS.md を作成します。
• 置き換えるのは ## Ovellum docs セクション（見出しから次の #/## 見出し、 またはファイル末尾まで）だけで、その周りはそのまま保持されます。
• セクションがすでに最新なら何も書き込みません — いつでも、フックからでも、 CI でも安全に再実行できます。

シノプシス#

ovellum agents [--cwd <dir>] [--config <path>] [--check]

フラグ#

出力#

ovellum agents:
  AGENTS.md  Ovellum docs section updated
  CLAUDE.md  already current

終了コード#

ovellum init も、既存の AGENTS.md がある場合に同じ更新を 行うので、新しくスキャフォールドしたプロジェクトと長く運用しているプロジェクトが 同じセクションに収束します。

共通フラグ#

真のグローバルではなく、多くのコマンドに共通して現れるフラグです: