> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cowagent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# edit - ファイル編集

> テキスト置換によるファイル編集

テキスト置換によるファイル編集を行います。ファイル全体を上書きする `write` と異なり、`edit` は変更する部分だけを送信するため高速で、ファイルの他の箇所を壊しにくくなります。既存ファイルを変更する場合はこちらを優先してください。`oldText` が空の場合、ファイル末尾に追記します。

## 依存関係

追加の依存関係は不要で、デフォルトで利用可能です。

## パラメータ

| パラメータ        | 型       | 必須  | 説明                                            |
| ------------ | ------- | --- | --------------------------------------------- |
| `path`       | string  | はい  | ファイルパス                                        |
| `oldText`    | string  | はい  | 置換対象の元テキスト。空白を含めファイル内と完全に一致する必要があります（空の場合は追記） |
| `newText`    | string  | はい  | 置換後のテキスト                                      |
| `replaceAll` | boolean | いいえ | 一致するすべての箇所を置換する。デフォルト false                   |

デフォルトでは `oldText` がファイル内で**一意**である必要があります。複数箇所に出現する場合はエラーとなり、前後の文脈を追加するよう促されます。誤った箇所を変更しないためです。本当にすべてを置換したい場合は `replaceAll=true` を指定してください。

<Note>
  `read` が返す各行には `12|` のような行番号の接頭辞が付いています。これは表示用でありファイルの内容ではないため、`oldText` / `newText` には含めないでください。
</Note>

## 安全チェック

書き込み前にいくつかのチェックが実行され、問題があれば結果に含めて通知します：

* **外部での変更**：Agent が読み取った後にそのファイルが他のプログラムによって変更されていた場合、警告が付きます。他者の変更を上書きしないためです。
* **構文チェック**：編集後の内容が JSON / YAML / TOML でパースに失敗する場合、**書き込みを拒否**しファイルはそのまま保持されます。これらの形式は途中まででは壊れているためです。ソースコード（`.py` など）は、今回の編集が新たな構文エラーを生じさせた場合にのみ警告し、書き込み自体は妨げません。
* **認証情報の保護**：API キーを保管する `~/.cow/.env` は本ツールでは変更できません。`env_config` ツールをご利用ください。

## ユースケース

* 設定ファイルの特定パラメータの変更
* コードのバグ修正
* ファイル内の特定位置へのコンテンツ挿入