インストール
Coppice Beta はデスクトップアプリとして配布しています。Docker もサーバーも Coppice アカウントも要りません。
対応プラットフォーム
| プラットフォーム | パッケージ |
|---|---|
| macOS (Apple Silicon) | .dmg |
| Linux (x64) | .deb |
この Beta に Windows アプリはありません。Windows 11 の場合は Windows 11(WSL 経由)を見てください。
ダウンロード
すべてのビルドは GitHub Releases からも入手できます。
アップデート
Coppice はバックグラウンドで新しいバージョンを確認します。オフにするには System → Updates を開き、Automatic updates をオフにします。アップデートしてもボードと設定はそのまま残ります。
- macOS: Coppice が更新をダウンロードします。バナーの Restart to update を選ぶか、次に Coppice を終了したときにインストールされます。
- Linux:
.debをインストールすると Coppice のパッケージソースが追加されるので、新しいバージョンはソフトウェアの更新でほかのアップデートと一緒に届きます。sudo apt update && sudo apt upgradeを実行しても構いません。
Windows 11(WSL 経由)
Linux x64 版は WSL を通して Windows 11 で動くはずです。まだ試していません。試した場合は、結果を教えてください。
Windows 11 が必要です。古い Windows 10 のビルドでは Linux アプリのウィンドウを表示できません。Arm 版 Windows の PC は今のところ対象外です。
-
PowerShell を管理者として開き、
wsl --installを実行します。Ubuntu がインストールされます。求められたら再起動し、Ubuntu のユーザー設定を済ませます。 -
管理者の PowerShell で WSL を更新し、Linux アプリのウィンドウが Windows のデスクトップに出るようにします。
wsl --update wsl --shutdown -
スタートメニューから Ubuntu を開きます。以降の手順は Ubuntu で行います。Linux x64 の
.debをダウンロードしてインストールします。<version>は GitHub Releases にある最新のバージョンに置き換えてください。cd ~ wget https://github.com/fertile-org/coppice/releases/download/v<version>/Coppice-<version>-linux-amd64.deb sudo apt install ./Coppice-<version>-linux-amd64.debdpkg -iではなくaptを使ってください。aptは Coppice に必要なものも一緒にインストールします。あとで Coppice をアップデートするには、
sudo apt update && sudo apt upgradeを実行します。ボードと設定はそのまま残ります。 -
使うエージェント CLI(Claude Code、Codex、Cursor、OpenCode、Kilo Code、GitHub Copilot、Qwen Code、Kimi Code、Grok)を Ubuntu にインストールします。CLI と git へのサインインも Ubuntu で行います。
-
Windows のスタートメニュー(Ubuntu の下)から Coppice を起動するか、Ubuntu で
coppiceを実行します。CLI に Not on your PATH と表示されたら、Ubuntu で
coppiceを実行して Coppice を起動してください。
WSL は Windows の PATH を Ubuntu に追加するので、Coppice が Windows 側の CLI を見つけてしまうことがあります。System → Connectors を開き、各コネクタの CLI のパスを確認してください。パスが /mnt/c/ で始まっていたら、その CLI を Ubuntu にインストールしてください。
リポジトリは /mnt/c/ の下ではなく、Linux のホームフォルダー(たとえば ~/code/my-app)に置いてください。その境界をまたぐと git やファイルへのアクセスがかなり遅くなります。フォルダーの選択画面には Linux のパスが表示されます。
初回の起動
-
Coppice をインストールして開きます。
-
ディスク上にすでにあるローカルの git チェックアウトを指定します。
-
エージェント CLI をつなぐ。 エージェントを作るときにエージェント CLI を選ぶと、Coppice がそれをオンにします。それぞれ Ready、Found, not signed in、Not on your PATH のどれかが表示されます。まずはいつもどおりの方法で、ターミナルで CLI にサインインしてください。
Kilo Code、GitHub Copilot、Qwen Code、Kimi Code は Installed(例:Kilo Code — Installed)と表示されます。System → Connectors には次の説明が付きます:“Coppice can’t check this sign-in without using your plan. A run will show an error if you’re signed out.”(Coppice はあなたのプランを使わずにこのサインインを確認できません。サインアウトしていると実行時にエラーが表示されます。)
あとでコネクタをオフにするには、System → Connectors のトグルを使うか、Coppice の
config.tomlでそのコネクタにenabled = falseを設定します。- macOS:
~/Library/Application Support/Coppice/config.toml - Linux:
~/.config/Coppice/config.toml
- macOS:
-
チケットを作成し(または提案されたチケットを承認し)、Ready に移します。エージェントが In Progress、In Review、In QA と進め、そのあとチケットはあなたの Human Review を待ちます。
必要なもの
- 書き込みできるローカルの git リポジトリ(Coppice は独立した worktree を使います)
- 対応するエージェント CLI を少なくとも 1 つ。そのツールのいつもの方法でインストールし、認証しておきます
トラブルシューティング
アプリが起動しない、またはエージェントがチケットに取りかからない場合は、チケットのライブターミナルとよくある質問を確認してください。ソースからビルドする方法は、リポジトリのコントリビューター向けドキュメントにあります。