harnsy をインストール
エージェントへのひと言か、コマンド1つ。インストーラーはあなたのユーザーアカウントの中だけで動き、ほかのツールの設定を変える前に必ず確認します。
インストールはエージェントに任せましょう。
これを Claude Code、Codex、OpenCode に貼り付けてください。エージェントはまず計画を見せ、次にインストールし、最後にインストーラーの質問にあなた自身のターミナルで答えるよう頼みます。設定ファイルをエージェントが自分で書き換えることはありません。
インストールは、エージェントへのひと言で済みます。
https://harnsy.dev/llms.txt の手順に従って harnsy をインストールしてまたはコマンド1つで。
エージェントを使わない同じインストールです。GitHub(harnesy/app)からデモ版をダウンロードします。
Linux と macOS
curl -fsSL https://harnsy.dev/install.sh | shWindows (PowerShell)
irm https://harnsy.dev/install.ps1 | iexLinux と macOS:すべての手順を表示し、何も変更しない
curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-runWindows:すべての手順を表示し、何も変更しない
$env:HARNSY_INSTALL_ARGS = "--dry-run"; irm https://harnsy.dev/install.ps1 | iex
デモ版:プロジェクト1つ、同時に動かせるエージェントは最大10、ノード・クラスターモードなし。
Linux、Windows、macOS(macOS は実機の Mac では未検証)。
インストーラーがすること
書き込むもの、確認すること、触れないものをすべて。harnsy install --dry-run はすべての手順、変更するファイルごとの diff、作成するファイルごとのパスを表示し、何も変更しません。
あなたのユーザーアカウントの中だけ。
すべてあなた自身のユーザーディレクトリに入ります。sudo も管理者権限も不要です。PATH やシェルのプロファイルは変更しません。~/.local/bin が PATH にない場合は、そう知らせます。
ダウンロードを検証します。
ワンライナーのインストーラーは、OS と CPU に合ったリリースを GitHub から HTTPS でダウンロードし、ファイルがリリースの SHA256SUMS にない、または一致しない場合は停止します。一時フォルダーに展開し、そこから harnsy install を実行し、終わるとそのフォルダーを削除します。この検証で分かるのは壊れたダウンロードや途中で切れたダウンロードです。チェックサムは同じリリースから取得しています。
確認なしで入れるのは3つだけ。
プログラム、インストール記録、そしてあなたのユーザー専用のバックグラウンドサービスです。サービスはすぐに起動し、ログインのたびに起動します。
| Linux | macOS | Windows | |
|---|---|---|---|
| プログラム(コピー) | ~/.local/bin/harnsy とリンク ~/.local/bin/ccbus | Linux と同じ | %LOCALAPPDATA%\harnsy\bin\harnsy.exe |
| インストール記録 | ~/.local/share/harnsy/install.json と hooks/harnsy-introduce.py | Linux と同じ | %LOCALAPPDATA%\harnsy\install.json |
| サービス:すぐに起動、ログイン時にも起動、クラッシュ後に再起動 | systemd ユーザーユニット ~/.config/systemd/user/harnsy.service | LaunchAgent ~/Library/LaunchAgents/com.github.butschster.harnsy.plist、ログは ~/Library/Logs/harnsy/ | タスク スケジューラのタスク harnsy(最小権限)。Windows が拒否した場合は HKCU\Software\Microsoft\Windows\CurrentVersion\Run の値 harnsy(クラッシュ後の再起動なし) |
別のサービスファイルやタスクがすでにある場合は、それを表示し、あなたが「はい」と答えたときだけ置き換えます。既存の ~/.local/bin/ccbus ファイルは ccbus.pre-harnsy に移されます。
それ以外はすべて先に確認します。
どれも [y/N] の質問です。有効なのは y または yes だけで、無回答、ターミナルなし、--dry-run はすべて「いいえ」になります。
- エージェントを開くターミナル(まだ選ばれていない場合のみ):WezTerm または tmux(tmux は Windows 以外)。
~/.harnsy/config.yamlのterminal.driverに保存されます。 - トレイアイコン(Linux、macOS):
~/.local/bin/harnsy-tray。ログイン時に起動するかは別の質問です。 - 新しいセッション用の起動フックを
~/.claude/settings.jsonと~/.codex/hooks.jsonに。~/.claudeまたは~/.codexがある場合のみ(Windows 以外)。 ~/.claude/settings.jsonのステータスライン。まだない場合のみ。
設定ファイルごとに、まず正確な変更内容を見せます。既存のファイルは先に ~/.local/share/harnsy/backups/(Windows:%LOCALAPPDATA%\harnsy\backups\)にコピーされます。代わりに「はい」と答えるオプションはありません。--no-tray、--no-hooks、--no-statusline で手順を省略できます。
あなたのマシンの中だけ。
ダッシュボード(127.0.0.1:7788)とエージェント用ポート(127.0.0.1:7790)は、このコンピューター上でのみ待ち受けます。サービスにはほかのノード用に 127.0.0.1:7789 も割り当てられますが、このポートはノードトークンを発行して初めて開き、デモ版では開きません。harnsy はテレメトリを送らず、更新も確認しません。通信するのは、このマシン上のあなたのハーネスと、あなたが接続したノードだけです。
触れないもの:
- MCP サーバー:任意の
claude mcp addの行を表示するので、実行はあなたが行います ~/.claude.json- Codex の
~/.codex/config.toml - OpenCode の設定
その後の動作中:config.yaml で claude.auto_trust: true にした場合に限り(既定ではオフ)、harnsy は Claude Code を開く前にプロジェクトフォルダーを ~/.claude.json で信頼済みにします。その前にファイルを ~/.harnsy の claude.json.bak にコピーします。harnsy が開く Codex には、フォルダーの信頼をコマンドラインフラグで渡すので、ファイルは書き込みません。
アンインストール。
harnsy uninstall はサービス、トレイ、プログラム、設定に追加した項目を削除し、設定を変更するたびに確認します。~/.harnsy のデータとバックアップは、あなたが削除するまで残ります。harnsy uninstall --dry-run で先にすべて確認できます。