設定リファレンス

Coppice は設定を 1 つのファイル config.toml に保存します。

OSパス
Linux~/.config/Coppice/config.toml
macOS~/Library/Application Support/Coppice/config.toml

Linux で XDG_CONFIG_HOME が設定されている場合、ファイルは $XDG_CONFIG_HOME/Coppice/config.toml にあります。

アプリで編集する

サイドバーで Settings を開きます。ファイルがテキストで表示され、コメントもそのまま残ります。

  • Save は書き込む前にファイルを確認します。不正な値は保存されません。
  • Restore last good version は、問題のある変更を元に戻します。

すぐに反映される変更もあれば、“Saved. Restart Coppice to apply.”(保存しました。反映するには Coppice を再起動してください)と表示されるものもあります。

ファイルは任意のテキストエディターでも編集できます。編集内容はアップグレードしても残ります。

アップデート

System → Updates を開くと、バージョンを確認して Check for updates を選べます。Automatic updates は既定でオンです。オフにすると、Coppice はバックグラウンドで新しいバージョンを確認しなくなります。

このスイッチは config.toml にはありません。Coppice は同じフォルダーの update-settings.json に automaticUpdates として保存します。

鍵を入れ替える

バックアップを共有した場合は、新しい鍵と新しい管理者パスワードを作ってください。保存済みのトークンはそのまま使え、全員がサインアウトされます。

System → Backup → Replace keys を開き、新しい管理者パスワードを入力して確定します。

ログ

管理者は System → Logs を開き、サーバー、リクエスト、エージェントの実行、データベースのログを絞り込んだり、ライブで追いかけたりできます。各実行には View logs のリンクがあります。

Export logs は、いまの絞り込みに合う行を coppice-logs.zip として保存します。Coppice は把握しているトークンと鍵を取り除きますが、共有する前にファイルを確認してください。

Report a problem は、Coppice のバージョンを記入済みの新しい GitHub issue を開きます。何が起きて、何を期待していたかを書き、Export logs で作った zip を添付してください。

[logs]

フィールド型既定値内容
retention_daysinteger14今日を含めて何日分のログを残すか:3、7、14、30。既定は 14 です。Coppice は 1 時間ごとに古いログを削除し、変更は再起動なしで反映されます。ログが 256 MiB を超えると、retention_days に達する前でも古いものから削除します。

1 日のログは、最大 32 MiB のファイルに分かれます。今日の分も含めて、すべてのファイルが 256 MiB の上限に数えられます。Coppice は、書き込み中のログファイルとデータベースのログは削除しません。データベースのログも上限に数えられ、retention_days を過ぎると削除されます。

フィールド型既定値内容
dirstring./data/logsログのフォルダー。デスクトップアプリは独自のフォルダーを使い、この値を無視します。変更には再起動が必要です。

コネクタ

Coppice が見つけた CLI は既定でオンです。ただし、サインイン確認でサインアウトしているとわかった CLI はオフです。オフにしたいときだけ 1 行書きます。

[agent.connectors.claude-code]
enabled = false

System → Connectors のスイッチも同じ行を書き込みます。

Kilo Code、GitHub Copilot、Qwen Code、Kimi Code は、Coppice が見つけた時点でオンになります。Coppice は無料でこれらのサインインを確認できないので、サインアウトしていると実行時にエラーが表示されます。

[agent]

フィールド型既定値内容
worktrees_pathstring<data-dir>/worktreesチケットごとの git worktree を置くフォルダー。
worker_countinteger8全コネクタ合わせたエージェントジョブの上限。1 未満は 1 として扱います。既存の worker_count = 2 は古い上限のままなので、他コネクタを止めることがあります。上げるか行を削除してください。
health_check_interval_secsinteger60エージェントのヘルスチェックの間隔(秒)。10 未満は 10 として扱います。

<data-dir> は config.toml があるフォルダーです。Linux と WSL では ~/.config/Coppice、macOS では ~/Library/Application Support/Coppice です。

[agent.connectors.<id>]

ID:claude-code、codex、cursor、opencode、kilo-code、copilot、qwen-code、kimi、grok。どのテーブルも省略できます。

フィールド型既定値内容
enabledbool未設定:CLI がサインイン済みならオンコネクタをオンまたはオフにします。
model_providerslist of strings[]このコネクタのモデルプロバイダー。オンにしたときに入力されます。
run_timeout_secsintegerすべてのコネクタで 1800このコネクタでの実行が失敗とみなされるまでの秒数。
max_concurrent_runsinteger2このコネクタが同時に動かせるジョブ数。超過分は queued のまま、空きが出たら古い順に始まります。1 未満は 1 です。
commandstringcursor-agent(Cursor)、codex、opencode、kilo、copilot、qwen、kimi、grok実行する CLI のバイナリ。Claude Code は常に claude を実行し、command はありません。

OpenCode のみ:

フィールド型既定値内容
serve_hostnamestring127.0.0.1実行中に使う OpenCode のヘルパーのホスト名。再起動が必要です。

OpenCode の command を変えた場合も再起動が必要です。

[workflow]

フィールド型既定値内容
auto_start_runsbooltruetrue の場合、リポジトリのあるチケットにエージェントを割り当てると実行が始まります。false の場合は Run agent をクリックします。
auto_assign.defaultbooltrue個別の設定がないすべてのステータスで自動割り当てをオンにします。
auto_assign.<status>boolbacklog:false。ほか:default に従う1 つのステータスについて自動割り当てをオンまたはオフにします。
auto_split.defaultboolfalse個別の設定がないすべてのステータスで自動分割をオンにします。
auto_split.<status>booldefault に従う1 つのステータスについて自動分割をオンまたはオフにします。

ステータスのキー:backlog、ready、in_progress、in_review、in_qa、wait_for_final_review(Wait for Human Review)、blocked、done。

そのステータスで自動割り当てがオンなら、Coppice は実行が指名したエージェントを割り当てます。オフなら、チケットには代わりに Recommends: が表示されます。

そのステータスで自動分割がオンなら、Coppice は実行が提案した子チケットを作ります。オフなら、Approve splits をクリックするまで Pending split recommendation として保存します。

[knowledge]

フィールド型既定値内容
enabledbooltrueKnowledge の圧縮をオンまたはオフにします。
poll_interval_msinteger500圧縮スケジューラーが起きる間隔。100 未満は 100 として扱います。
compaction.interval_secsinteger1800圧縮サイクルの間隔(秒)。
compaction.batch_max_ticketsinteger101 回のバッチに入るチケットの最大数。
compaction.batch_max_source_bytesinteger2000001 回のバッチに入るソースの最大バイト数。
compaction.max_candidates_per_batchinteger201 回のバッチが提案できる候補の最大数。
compaction.max_attemptsinteger31 回のバッチを試す最大回数。
auto_save.enabledboolfalseリスクの低い候補を確認なしで保存します。
auto_save.allowed_typeslist of strings[]自動保存してよい種類:bug_pattern、coding_convention、dependency_note、performance_note、review_feedback、test_command。
auto_save.minimum_confidencestringhighhigh のままにする必要があります。
retrieval.top_kinteger81 回の検索で返す件数。1〜20。
retrieval.allowed_typeslist of strings[](すべての種類)これらの種類だけを返します:coding_convention、architecture_rule、bug_pattern、test_command、review_feedback、dependency_note、api_contract、workflow_rule、human_preference、operational_runbook、security_rule、performance_note。
retrieval.minimum_confidencestringmediumlow、medium、high のいずれか。
retrieval.default_page_sizeinteger25既定のページサイズ。
retrieval.max_page_sizeinteger100最大のページサイズ。最大 100 です。
retrieval.max_active_per_boardinteger10001 つのボードが持てる Knowledge 項目(保留中または承認済み)の最大数。そのボードのエージェントの項目も数えます。
retrieval.max_active_workspaceinteger10000ワークスペース全体に適用される Knowledge 項目(保留中または承認済み)の最大数。

上の件数と間隔はすべて 0 より大きくする必要があります。

[git]

フィールド型既定値内容
author_namestringCoppiceCoppice が作るコミットの作者名。
author_emailstringcoppice@localhostそれらのコミットの作者のメールアドレス。
push_enabledboolfalse(デスクトップアプリでは true)Coppice にブランチのプッシュとプルリクエストの作成を許可します。

[plugins]

フィールド型既定値内容
dirstring<data-dir>/plugins既定のプラグインフォルダー。Plugins ページでフォルダーを追加できます。
allow_file_git_urlsboolfalseプラグインのインストールに file: の git URL を使えるようにします。
git_timeout_secsinteger300プラグインのクローンや更新が失敗とみなされるまでの秒数。
mcp_start_timeout_secsinteger20プラグインの MCP サーバーの起動を待つ秒数。
mcp_list_timeout_secsinteger10プラグインがツールを一覧にするのを待つ秒数。
mcp_idle_shutdown_secsinteger600使われていないプラグインの MCP サーバーを動かしておく秒数。

[mcp]

フィールド型既定値内容
builtin_plugins_dirstring<data-dir>/builtin-pluginsCoppice が起動のたびに組み込みスキルを書き出す場所。ここでの編集は失われます。
call_timeout_secsinteger601 回のツール呼び出しが失敗とみなされるまでの秒数。
max_output_bytesinteger32768ツールの結果の最大バイト数。
comment_post_limitinteger51 回の実行が投稿できるコメントの最大数。
token_ttl_secsinteger14400実行のツールトークンが有効な秒数。

[keybindings]

各キーはキーボードショートカットのコマンド ID です。あなたのキーがそのコマンドの既定のキーに置き換わり、空の値にするとショートカットがオフになります。

フィールド型既定値内容
"<command id>"string or list of strings組み込みのショートカットそのコマンドのキーを置き換えます。"" で削除します。
[keybindings]
"palette.open" = "P"
"ticket.create" = ""
"board.nextCard" = ["J", "Down"]

Mod は macOS では Cmd、Linux と WSL では Ctrl です。連続したキーは G then B のように書きます。1 つのコマンドに複数のキーを割り当てるときは、or で区切るか、リストで書きます。Save すると、再起動なしで反映されます。Coppice が読めないショートカット、存在しないコマンド ID、ほかのコマンドがすでに使っているキー、ブラウザーやシステムのキーは使われません。そのコマンドは既定のキーのままになり、Settings に理由が表示されます。