---
title: 設定
description: JSON、JSONC、JSON5、JavaScript、TypeScript設定ファイルで、出力形式、includeとignoreパターン、高度なオプションを含むRepomixの設定方法を説明します。
---

# 設定

Repomixは設定ファイルまたはコマンドラインオプションを使用して設定できます。設定ファイルを使用することで、コードベースの処理と出力方法をカスタマイズできます。

## 設定ファイルの形式

Repomixは柔軟性と使いやすさのために、複数の設定ファイル形式をサポートしています。

Repomixは以下の優先順位で設定ファイルを自動的に検索します：

1. **TypeScript** (`repomix.config.ts`、`repomix.config.mts`、`repomix.config.cts`)
2. **JavaScript/ES Module** (`repomix.config.js`、`repomix.config.mjs`、`repomix.config.cjs`)
3. **JSON** (`repomix.config.json5`、`repomix.config.jsonc`、`repomix.config.json`)

### JSON設定

プロジェクトディレクトリに設定ファイルを作成します：
```bash
repomix --init
```

これにより、デフォルト設定の`repomix.config.json`ファイルが作成されます。また、ローカル設定が見つからない場合のフォールバックとして使用されるグローバル設定ファイルを作成することもできます：

```bash
repomix --init --global
```

### TypeScript設定

TypeScript設定ファイルは、完全な型チェックとIDEサポートにより、最高の開発者体験を提供します。

**インストール:**

`defineConfig`を使用してTypeScriptまたはJavaScript設定を使用するには、Repomixをdev dependencyとしてインストールする必要があります：

```bash
npm install -D repomix
```

**例:**

```typescript
// repomix.config.ts
import { defineConfig } from 'repomix';

export default defineConfig({
  output: {
    filePath: 'output.xml',
    style: 'xml',
    removeComments: true,
  },
  ignore: {
    customPatterns: ['**/node_modules/**', '**/dist/**'],
  },
});
```

**利点:**
- ✅ IDEでの完全なTypeScript型チェック
- ✅ 優れたIDE自動補完とIntelliSense
- ✅ 動的な値（タイムスタンプ、環境変数など）の使用

**動的な値の例:**

```typescript
// repomix.config.ts
import { defineConfig } from 'repomix';

// タイムスタンプベースのファイル名を生成
const timestamp = new Date().toISOString().slice(0, 19).replace(/[:.]/g, '-');

export default defineConfig({
  output: {
    filePath: `output-${timestamp}.xml`,
    style: 'xml',
  },
});
```

### JavaScript設定

JavaScript設定ファイルはTypeScriptと同様に機能し、`defineConfig`と動的な値をサポートしています。

## 設定オプション

| オプション                        | 説明                                                                                                                         | デフォルト値           |
|----------------------------------|------------------------------------------------------------------------------------------------------------------------------|------------------------|
| `input.maxFileSize`              | 処理する最大ファイルサイズ（バイト）。これより大きいファイルはスキップされます。大きなバイナリファイルやデータファイルを除外するのに便利です | `50000000`            |
| `output.filePath`                | 出力ファイル名。XML、Markdown、プレーンテキスト形式をサポートしています                                                      | `"repomix-output.xml"` |
| `output.style`                   | 出力形式（`xml`、`markdown`、`json`、`plain`）。各形式はAIツールに応じて異なる利点があります                                        | `"xml"`                |
| `output.filePathStyle`           | 出力内でのファイルパスの表示方法（`target-relative` は各ターゲットルートからの相対パス、`cwd-relative` はカレントワーキングディレクトリからの相対パスを使用）   | `"target-relative"`    |
| `output.parsableStyle`           | 選択したスタイルスキーマに基づいて出力をエスケープするかどうか。より良い解析が可能になりますが、トークン数が増加する可能性があります | `false`                |
| `output.compress`                | Tree-sitterを使用してインテリジェントなコード抽出を実行し、構造を保持しながらトークン数を削減するかどうか                  | `false`                |
| `output.patterns`                | ファイルごとのインクルードレベル。`{ pattern, compress?, directoryStructureOnly? }`エントリの順序付き配列で、最初にマッチしたglobが優先され、そのファイルに対するグローバルな`output.compress`を上書きします。[ファイルごとのインクルードレベル](#ファイルごとのインクルードレベル)を参照してください | 未設定                 |
| `output.headerText`              | ファイルヘッダーに含めるカスタムテキスト。AIツールにコンテキストや指示を提供するのに便利です                              | `null`                 |
| `output.instructionFilePath`     | AI処理用の詳細なカスタム指示を含むファイルへのパス                                                                          | `null`                 |
| `output.fileSummary`             | ファイル数、サイズ、その他のメトリクスを示す要約セクションを出力の先頭に含めるかどうか                                    | `true`                 |
| `output.directoryStructure`      | 出力にディレクトリ構造を含めるかどうか。AIがプロジェクトの構成を理解するのに役立ちます                                    | `true`                 |
| `output.files`                   | 出力にファイル内容を含めるかどうか。falseに設定すると、構造とメタデータのみが含まれます                                   | `true`                 |
| `output.removeComments`          | サポートされているファイルタイプからコメントを削除するかどうか。ノイズとトークン数を削減できます                          | `false`                |
| `output.removeEmptyLines`        | 出力から空行を削除してトークン数を削減するかどうか                                                                          | `false`                |
| `output.showLineNumbers`         | 各行に行番号を追加するかどうか。コードの特定の部分を参照するのに役立ちます                                                 | `false`                |
| `output.truncateBase64`          | 長いbase64データ文字列（例：画像）を切り詰めてトークン数を削減するかどうか                                                | `false`                |
| `output.copyToClipboard`         | ファイルの保存に加えて、出力をシステムクリップボードにコピーするかどうか                                                   | `false`                |
| `output.splitOutput`             | パートあたりの最大サイズで出力を複数の番号付きファイルに分割します（例：`1000000`で約1MB）。CLIは`500kb`や`2mb`のような読みやすいサイズを受け付けます。各ファイルが制限以下に保たれ、単一のソースファイルがパート間で分割されることを防ぎます | 未設定 |
| `output.tokenBudget`             | パックした出力がこのトークン数を超えた場合、ゼロ以外の終了コードで失敗します。CI/エージェントのコンテキスト制限に対するガードとして機能します。出力自体は生成されます | 未設定 |
| `output.topFilesLength`          | 要約に表示するトップファイルの数。0に設定すると、要約は表示されません                                                       | `5`                    |
| `output.includeEmptyDirectories` | リポジトリ構造に空のディレクトリを含めるかどうか                                                                           | `false`                |
| `output.includeFullDirectoryStructure` | `include`パターンを使用する際、includeされたファイルのみを処理しながら、完全なディレクトリツリー（ignoreパターンに従う）を表示するかどうか。AI分析のための完全なリポジトリコンテキストを提供します | `false`                |
| `output.git.sortByChanges`       | Gitの変更回数でファイルをソートするかどうか。変更が多いファイルが下部に表示されます                                       | `true`                 |
| `output.git.sortByChangesMaxCommits` | Gitの変更を分析する最大コミット数。パフォーマンスのために履歴の深さを制限します                                       | `100`                  |
| `output.git.includeDiffs`        | 出力にGitの差分を含めるかどうか。作業ツリーとステージング済みの変更を別々に表示します                                     | `false`                |
| `output.git.includeLogs`         | 出力にGitログを含めるかどうか。コミット履歴の日時、メッセージ、ファイルパスを表示します                                   | `false`                |
| `output.git.includeLogsCount`    | 含めるGitログのコミット数。開発パターンを理解するための履歴の深さを制限します                                           | `50`                   |
| `include`                        | 含めるファイルのパターン（[globパターン](https://github.com/mrmlnc/fast-glob?tab=readme-ov-file#pattern-syntax)を使用）    | `[]`                   |
| `ignore.useGitignore`            | プロジェクトの`.gitignore`ファイルのパターンを使用するかどうか                                                             | `true`                 |
| `ignore.useDotIgnore`            | プロジェクトの`.ignore`ファイルのパターンを使用するかどうか                                                                | `true`                 |
| `ignore.useDefaultPatterns`      | デフォルトの除外パターン（node_modules、.gitなど）を使用するかどうか                                                       | `true`                 |
| `ignore.customPatterns`          | 追加の除外パターン（[globパターン](https://github.com/mrmlnc/fast-glob?tab=readme-ov-file#pattern-syntax)を使用）          | `[]`                   |
| `security.enableSecurityCheck`   | Secretlintを使用して機密情報を検出するセキュリティチェックを実行するかどうか                                               | `true`                 |
| `tokenCount.encoding`            | OpenAI互換のトークンカウントエンコーディング（GPT-4oの場合は`o200k_base`、GPT-4/3.5の場合は`cl100k_base`）。[gpt-tokenizer](https://github.com/nicolo-ribaudo/gpt-tokenizer)を使用。 | `"o200k_base"`         |

設定ファイルは[JSON5](https://json5.org/)構文をサポートしており、以下が可能です：
- コメント（単一行および複数行）
- オブジェクトと配列の末尾のカンマ
- 引用符なしのプロパティ名
- より柔軟な文字列構文

## スキーマ検証

設定ファイルに`$schema`プロパティを追加することで、スキーマ検証を有効にできます：

```json
{
  "$schema": "https://repomix.com/schemas/latest/schema.json",
  "output": {
    "filePath": "repomix-output.md",
    "style": "markdown"
  }
}
```

これにより、JSONスキーマをサポートするエディタでの自動補完と検証が可能になります。

## 設定ファイルの例

以下は完全な設定ファイル（`repomix.config.json`）の例です：

```json
{
  "$schema": "https://repomix.com/schemas/latest/schema.json",
  "input": {
    "maxFileSize": 50000000
  },
  "output": {
    "filePath": "repomix-output.xml",
    "style": "xml",
    "filePathStyle": "target-relative",
    "parsableStyle": false,
    "compress": false,
    "headerText": "パッケージ化されたファイルのカスタムヘッダー情報",
    "fileSummary": true,
    "directoryStructure": true,
    "files": true,
    "removeComments": false,
    "removeEmptyLines": false,
    "topFilesLength": 5,
    "showLineNumbers": false,
    // "patterns": [
    //   { "pattern": "docs/**/*", "compress": true },
    //   { "pattern": "website/**/*", "directoryStructureOnly": true }
    // ],
    "truncateBase64": false,
    "copyToClipboard": false,
    "includeEmptyDirectories": false,
    "git": {
      "sortByChanges": true,
      "sortByChangesMaxCommits": 100,
      "includeDiffs": false,
      "includeLogs": false,
      "includeLogsCount": 50
    }
  },
  "include": ["**/*"],
  "ignore": {
    "useGitignore": true,
    "useDefaultPatterns": true,
    // パターンは .repomixignore でも指定できます
    "customPatterns": [
      "additional-folder",
      "**/*.log"
    ],
  },
  "security": {
    "enableSecurityCheck": true
  },
  "tokenCount": {
    "encoding": "o200k_base"
  }
}
```

## 設定ファイルの場所

Repomixは以下の順序で設定ファイルを探します：
1. カレントディレクトリのローカル設定ファイル（優先順位: TS > JS > JSON）
   - TypeScript: `repomix.config.ts`、`repomix.config.mts`、`repomix.config.cts`
   - JavaScript: `repomix.config.js`、`repomix.config.mjs`、`repomix.config.cjs`
   - JSON: `repomix.config.json5`、`repomix.config.jsonc`、`repomix.config.json`
2. グローバル設定ファイル（優先順位: TS > JS > JSON）
   - Windows:
     - TypeScript: `%LOCALAPPDATA%\Repomix\repomix.config.ts`、`.mts`、`.cts`
     - JavaScript: `%LOCALAPPDATA%\Repomix\repomix.config.js`、`.mjs`、`.cjs`
     - JSON: `%LOCALAPPDATA%\Repomix\repomix.config.json5`、`.jsonc`、`.json`
   - macOS/Linux:
     - TypeScript: `~/.config/repomix/repomix.config.ts`、`.mts`、`.cts`
     - JavaScript: `~/.config/repomix/repomix.config.js`、`.mjs`、`.cjs`
     - JSON: `~/.config/repomix/repomix.config.json5`、`.jsonc`、`.json`

コマンドラインオプションは設定ファイルの設定よりも優先されます。

## インクルードパターン

Repomixは[globパターン](https://github.com/mrmlnc/fast-glob?tab=readme-ov-file#pattern-syntax)を使用して含めるファイルを指定できます。これにより、より柔軟で強力なファイル選択が可能になります：

- `**/*.js`を使用して、任意のディレクトリ内のすべてのJavaScriptファイルを含める
- `src/**/*`を使用して、`src`ディレクトリとそのサブディレクトリ内のすべてのファイルを含める
- `["src/**/*.js", "**/*.md"]`のように複数のパターンを組み合わせて、`src`内のJavaScriptファイルとすべてのMarkdownファイルを含める

設定ファイルでインクルードパターンを指定できます：

```json
{
  "include": ["src/**/*", "tests/**/*.test.js"]
}
```

または、一時的なフィルタリングには`--include`コマンドラインオプションを使用します。

## 除外パターン

Repomixは、パッキングプロセス中に特定のファイルやディレクトリを除外するための複数の方法を提供します：

- **.gitignore**: デフォルトでは、プロジェクトの`.gitignore`ファイルと`.git/info/exclude`にリストされているパターンが使用されます。この動作は`ignore.useGitignore`設定または`--no-gitignore` CLIオプションで制御できます。
- **.ignore**: プロジェクトルートに`.ignore`ファイルを使用できます。`.gitignore`と同じ形式に従います。このファイルはripgrepやthe silver searcherなどのツールでも尊重されるため、複数の除外ファイルを維持する必要が減ります。この動作は`ignore.useDotIgnore`設定または`--no-dot-ignore` CLIオプションで制御できます。
- **デフォルトパターン**: Repomixには、一般的に除外されるファイルとディレクトリのデフォルトリスト（例：node_modules、.git、バイナリファイル）が含まれています。この機能は`ignore.useDefaultPatterns`設定または`--no-default-patterns` CLIオプションで制御できます。詳細は[defaultIgnore.ts](https://github.com/yamadashy/repomix/blob/main/src/config/defaultIgnore.ts)を参照してください。
- **.repomixignore**: プロジェクトルートに`.repomixignore`ファイルを作成して、Repomix固有の除外パターンを定義できます。このファイルは`.gitignore`と同じ形式に従います。
- **カスタムパターン**: 設定ファイルの`ignore.customPatterns`オプションを使用して、追加の除外パターンを指定できます。この設定は`-i, --ignore`コマンドラインオプションで上書きできます。

**優先順位**（高い順）：

1. カスタムパターン（`ignore.customPatterns`）
2. 除外ファイル（`.repomixignore`、`.ignore`、`.gitignore`、`.git/info/exclude`）：
   - ネストされたディレクトリにある場合、より深いディレクトリのファイルが優先されます
   - 同じディレクトリにある場合、これらのファイルは順不同でマージされます
3. デフォルトパターン（`ignore.useDefaultPatterns`がtrueで`--no-default-patterns`が使用されていない場合）

このアプローチにより、プロジェクトのニーズに基づいて柔軟なファイル除外設定が可能になります。セキュリティ上機密性の高いファイルや大きなバイナリファイルの除外を確実にし、機密情報の漏洩を防ぎながら、生成されるパックファイルのサイズを最適化するのに役立ちます。

**注意:** バイナリファイルはデフォルトではパック出力に含まれませんが、そのパスは出力ファイルの「リポジトリ構造」セクションにリストされます。これにより、パックファイルを効率的でテキストベースに保ちながら、リポジトリ構造の完全な概要が提供されます。詳細は[バイナリファイルの処理](#バイナリファイルの処理)を参照してください。

`.repomixignore`の例：
```text
# キャッシュディレクトリ
.cache/
tmp/

# ビルド出力
dist/
build/

# ログ
*.log
```

## デフォルトの除外パターン

`ignore.useDefaultPatterns`がtrueの場合、Repomixは以下のような一般的なパターンを自動的に除外します：
```text
node_modules/**
.git/**
coverage/**
dist/**
```

完全なリストは[defaultIgnore.ts](https://github.com/yamadashy/repomix/blob/main/src/config/defaultIgnore.ts)を参照してください。

## バイナリファイルの処理

バイナリファイル（画像、PDF、コンパイル済みバイナリ、アーカイブなど）は、効率的なテキストベースの出力を維持するために特別に処理されます：

- **ファイル内容**: バイナリファイルは、ファイルをテキストベースに保ち、AI処理に効率的にするために、パック出力に**含まれません**
- **ディレクトリ構造**: バイナリファイルの**パスはリストされ**、ディレクトリ構造セクションに表示され、リポジトリの完全な概要を提供します

このアプローチにより、AI向けに最適化された効率的なテキストベースの出力を維持しながら、リポジトリ構造の完全なビューを取得できます。

**例：**

リポジトリに`logo.png`と`app.jar`が含まれている場合：
- ディレクトリ構造セクションに表示されます
- その内容はファイルセクションに含まれません

**ディレクトリ構造出力：**
```
src/
  index.ts
  utils.ts
assets/
  logo.png
build/
  app.jar
```

これにより、AIツールはこれらのバイナリファイルがプロジェクト構造に存在することを理解できますが、そのバイナリ内容は処理しません。

**注意:** `input.maxFileSize`設定オプション（デフォルト：50MB）を使用して、最大ファイルサイズのしきい値を制御できます。この制限より大きいファイルは完全にスキップされます。

## 高度な機能

### コード圧縮

`output.compress: true`で有効になるコード圧縮機能は、[Tree-sitter](https://github.com/tree-sitter/tree-sitter)を使用して、実装の詳細を削除しながら本質的なコード構造を抽出します。これにより、重要な構造情報を維持しながらトークン数を削減できます。

主な利点：
- トークン数を大幅に削減
- クラスと関数のシグネチャを保持
- インポートとエクスポートを維持
- 型定義とインターフェースを保持
- 関数本体と実装の詳細を削除

詳細と例については[コード圧縮ガイド](code-compress)をご覧ください。

### ファイルごとのインクルードレベル

`output.compress`はすべてのファイルに単一のレベルを適用しますが、`output.patterns`を使用すると、設定ファイルから**globごと**に詳細レベルを制御できます。各エントリはglob（`include`/`ignore`と同じ方法でマッチします）でファイルを対象とし、マッチしたファイルに対するグローバルな`output.compress`設定を上書きします。

```json5
{
  "output": {
    "compress": false, // グローバルなデフォルトがキャッチオールとして機能します
    "patterns": [
      { "pattern": "docs/**/*", "compress": true },
      { "pattern": "website/**/*", "directoryStructureOnly": true }
    ]
  }
}
```

各ファイルは次の3つのレベルのいずれかに解決されます：

- **完全な内容**（デフォルト）：ファイルの完全な内容が含まれます。
- **圧縮**（`compress: true`）：内容は`output.compress`と同じTree-sitterパイプラインを通過します。
- **ディレクトリ構造のみ**（`directoryStructureOnly: true`）：ファイルはディレクトリ構造にリストされますが、その内容ブロックは出力から完全に省略されます。

ルール：

- パターンは配列の順序で評価され、特定のファイルに対して**最初にマッチしたパターンが優先**されます。
- マッチしたパターンのフラグは、グローバルな`output.compress`設定を上書きします。フラグを設定せずにマッチしたパターンは、そのファイルに対して**完全な内容**を強制します。これは、グローバルな`compress`からファイルをホワイトリスト登録するのに便利です。
- 同じパターンに両方が設定されている場合、`directoryStructureOnly`が`compress`よりも優先されます。
- どのパターンにもマッチしない場合、グローバルな動作が適用されます（完全な内容、または`output.compress`が`true`の場合は圧縮）。

このオプションは設定ファイル専用であり、同等のCLIフラグはありません。

### Git統合

`output.git`設定では、以下のようなGit対応機能を提供します：

- `sortByChanges`: trueに設定すると、ファイルはGitの変更回数（そのファイルを変更したコミット数）でソートされます。変更が多いファイルが出力の下部に表示されます。これは、より活発に開発されているファイルを優先するのに役立ちます。デフォルト: `true`
- `sortByChangesMaxCommits`: ファイルの変更回数を数える際に分析する最大コミット数。デフォルト: `100`
- `includeDiffs`: trueに設定すると、Git差分を出力に含めます（ワークツリーとステージング済みの変更を別々に含みます）。これにより、リポジトリの保留中の変更を確認できます。デフォルト: `false`
- `includeLogs`: trueに設定すると、Gitログを出力に含めます。コミット履歴の日時、メッセージ、ファイルパスが表示され、AIがどのファイルが一緒に変更される傾向があるかを理解できます。デフォルト: `false`
- `includeLogsCount`: 含めるGitログのコミット数。開発パターンの分析に使用する履歴の深さを制御します。デフォルト: `50`

設定例：
```json
{
  "output": {
    "git": {
      "sortByChanges": true,
      "sortByChangesMaxCommits": 100,
      "includeDiffs": true,
      "includeLogs": true,
      "includeLogsCount": 30
    }
  }
}
```

### セキュリティチェック

`security.enableSecurityCheck`が有効な場合、Repomixは[Secretlint](https://github.com/secretlint/secretlint)を使用して、出力に含める前にコードベース内の機密情報を検出します。これにより、以下のような情報の誤った露出を防ぐことができます：

- APIキー
- アクセストークン
- 秘密鍵
- パスワード
- その他の機密情報

### コメントの削除

`output.removeComments`を`true`に設定すると、サポートされているファイルタイプからコメントが削除され、出力サイズを削減し、本質的なコード内容に焦点を当てることができます。これは以下のような場合に特に便利です：

- 大量にドキュメント化されたコードを扱う場合
- トークン数を削減したい場合
- コードの構造とロジックに集中したい場合

サポートされている言語と詳細な例については[コメント削除ガイド](comment-removal)をご覧ください。

## 関連リソース

- [コマンドラインオプション](/ja/guide/command-line-options) - CLIリファレンス（CLIオプションは設定ファイルより優先）
- [出力フォーマット](/ja/guide/output) - 各出力形式の詳細
- [セキュリティ](/ja/guide/security) - 機密情報検出の仕組み
- [コード圧縮](/ja/guide/code-compress) - Tree-sitterによるトークン数削減
- [GitHubリポジトリの処理](/ja/guide/remote-repository-processing) - リモートリポジトリのオプション
