TechRetriever
TechRetriever 公式サイト

bashスクリプトをLinuxとWSLで、一歩ずつ確認しながら

TechRetriever は Windows 10/11 用のエージェントです。Bash のスクリプトを下書きし、あなたが所有するシステム上で WSL または SSH 経由で実行して、すべての結果を開けるカードとして表示します。バージョンは 2.9.30 です。

TechRetriever をダウンロード ↗スクリプトのワークフローを見る
プラットフォーム

Windows 10/11

64ビット版インストーラーとポータブル版

バージョン

2.9.30

2026年11月8日リリース

スクリプト

WSL または SSH

あなたが所有する Linux システムで実行

承認

Ask first

何かを変更する操作の前に一時停止

モデル

クラウド、ローカル、内蔵

選んでから Test を押します

アカウント

不要

アプリの実行には必要ありません

基本

自分のマシンで使うbashスクリプトの基本

bashスクリプトとは、シェルコマンドを通常はテキストファイル(拡張子は多くの場合 .sh)にまとめ、Bash に順番に実行させるものです。まず小さく始めましょう。1行目にはシバン(shebang)、たとえば #!/usr/bin/env bash を書き、そのあとで変数、条件分岐、ループ、関数を使います。どのコマンドも終了コードを返し、0 は成功を意味します。TechRetriever はこうしたファイルを下書きして実行し、あなたは各ステップを読みながら確認できます。

01

日付入りの tar ファイルでフォルダをバックアップする

シェルスクリプトの入門は自動バックアップから始まることが多いので、エージェントに、1つのフォルダを日付入りの tar ファイルにコピーするスクリプトを頼んでみましょう。エージェントは write_file で backup-notes.sh を保存し、Shell が bash -n を実行して、スクリプトを走らせずに構文だけを確認します。まだ何もコピーされません。Ask first モードでは、何かを変更する操作の前にエージェントが一時停止し、カードには実際のコマンドと本物の終了コードが表示されます。0 は成功です。最初の本番実行の前に、フォルダを手作業でバックアップしてください。また、tar コマンドをまず echo で表示するドライランも行いましょう。

ツールのトレース
list_dir  notes  → 3 entries
write_file  backup-notes.sh  → saved
Shell  bash -n backup-notes.sh  → exit 0
Shell  bash backup-notes.sh  → waiting for your OK
02

手元にあるスクリプトで Bash を学ぶ

古いスクリプトを開いて、1行ずつ何をしているのか尋ねてみましょう。read_file がスクリプトを読み込み、grep が特定の変数を設定または使用しているすべての行を一覧にします。エージェントは1行目のシバン、クォート、終了コードを平易な言葉で説明します。クォートされていない変数があれば指摘します。説明のたびにループや条件分岐といった見つけた概念の名前が示されるので、読みながら用語が身につきます。組み込みコマンドの意味があいまいなときは、http_get が公式のマニュアルページを読み、その本文に基づいて答えます。説明だけが欲しいときは Plan only に切り替えてください。

ツールのトレース
read_file  old-cleanup.sh  → 24 lines
grep  "$dir" old-cleanup.sh  → 5 matches
http_get  manual page for a builtin  → read
03

ログから特定の単語を検索する

自分のシステムのログを作業フォルダにコピーして、timeout のような単語を含む行を尋ねてみましょう。grep が一致した行を返し、前後の流れが必要なときは read_file がファイル全体を開きます。文字列の解析にもエージェントは役立ちます。ログを1行貼り付けて、それをフィールドに分割し、echo で1つずつ表示するループを頼んでください。write_file がそのループを parse-log.sh として保存し、以降の変更はすべて edit_file が diff として表示します。作業は必ずコピーに対して行いましょう。

04

手で打ったコマンドを引数付きのスクリプトにする

Bash でのコーディングは、実はこの作業そのものであることが多いのです。何度も打ち込んだコマンドが、$1 と $2 から入力を受け取るファイルに変わります。繰り返し打っているコマンドを貼り付けて、使い方メッセージと、2つの引数が揃っているかのチェックを頼みましょう。write_file がスクリプトを保存し、Shell が bash -x を実行して、実行前に各コマンドを表示します。トレースを読みましょう。おかしな部分は edit_file で直し、何かを変更するステップを承認したりスクリプトを再利用したりする前に、トレースを期待した動きと見比べてください。

ワークフローガイドを読む

一般的なチャットアシスタントとの違い

助言だけでは足りません。TechRetriever 2.9.30 はさらに一歩進み、Shell コマンドを自分で実行して本物の終了コードを表示するので、推測ではなく結果で判断できます。

一般的なチャットアシスタントTechRetriever
実行スクリプトをコピーして自分で実行しますShell が実行し、本物の終了コードを表示します
編集新しいスクリプト全体をチャットに貼り付けますedit_file がファイルを変更し、diff を表示します
制御何も実行しないので、承認するものがありませんAsk first が、何かを変更する操作の前に一時停止します
コンテキスト貼り付けた内容しか見えませんread_file と grep が、スクリプトやログを読み取ります

使い方

  1. Windows 10 または 11 に TechRetriever をインストールします。その前に、SHA-256 チェックサムを公開されているマニフェストと照合してください。
  2. モデルを接続します。クラウドの AI プロバイダー、PC 上で動くローカルモデル、または内蔵モデルから選べます。
  3. プロジェクトのフォルダと、Auto-run、Ask first、Plan only のいずれかのモードを選びます。
  4. 必要なスクリプトを説明し、各アクションのカードを読み、依頼内容と合う diff だけを承認します。

こんな方に向いています

まず想定しているのは、スクリプトを一度も書いたことがない初心者です。Windows から Bash を学び始めて、1行ごとの動きを確かめたい方も含みます。小さく始めましょう。WSL で1つスクリプトを書き、1行ずつ読み、何かを実行する前にエージェントに各部分の説明を頼んでください。

自分で Linux マシンを数台持っている実務者は、繰り返す作業に使います。自宅サーバーやテスト環境の Bash プログラミングなら、ログの検索、ディスクのチェック、日付入りバックアップ、自分のサーバー一覧を回すループなどです。作業はそれぞれ引数付きのスクリプトになります。あなたは diff を確認します。

3つ目のグループは、SSH で Linux システムを管理する Windows ユーザーです。このツールは、所有または管理しているサーバー専用です。スクリプトは Linux 側で動き、TechRetriever は Windows 10 または 11 上にとどまります。Ask first モードでは、何かを変更する操作の前にエージェントが一時停止し、Plan only では何も実行されません。対象は毎回確認してください。

よくある質問

bashスクリプトとは何ですか?

bashスクリプトとは、シェルコマンドを通常は拡張子 .sh のテキストファイルにまとめ、Bash に順番に実行させる方法です。まずシバンの行から始めます。変数、条件分岐、ループ、関数を加え、各コマンドの終了コードを確認します。0 は成功を意味します。

techretriever.com は TechRetriever の公式サイトですか?

はい。techretriever.com は TechRetriever の公式サイトで、リンク先のインストーラーはオリジナルのビルドです。インストーラーにはまだコード署名がないため、SHA-256 チェックサムを公開マニフェストと照合してください。質問はアプリ内の Send feedback ボタンからお寄せください。

Bash スクリプトは実際にどこで動きますか?

スクリプトは、お使いの PC 上の WSL か、SSH で接続するあなた所有の Linux システムで動きます。TechRetriever 自体は Windows 10 または 11 で動作します。対象範囲は狭く保ってください。所有または管理する権限のあるマシン専用で、その確認はアプリが代わりに行うことはありません。

読む前にエージェントがスクリプトを実行しないようにできますか?

はい。確実なのは Plan only です。計画を書くだけで、コマンドの実行もファイルの変更も一切行いません。Ask first は何かを変更する操作の前に一時停止しますが、読み取り専用のコマンドは止まらずに実行されることがあります。Auto-run は即座に動くので、確認済みの作業にだけ使ってください。

仕事用サーバーで Bash プログラミングに使えますか?

はい。そのサーバーを管理する権限があれば使えます。まずテストしてください。スクリプトは自分のマシンかテスト用サーバーで実行し、ファイルを変更したり削除したりするスクリプトの前にはバックアップを取り、承認する前にすべてのコマンドを読みましょう。

スクリプトやプロンプトは PC の外に送信されますか?

クラウドモデルには、エージェントが読んだファイルの内容を含むプロンプトのテキストが送られるため、そのプロバイダーにはスクリプトの中身が見えます。ローカルモデルなら話は別で、何も PC の外に出ません。どちらの場合も、チャット、作業フォルダ、API キーは PC に残ります。

エージェントはスクリプトが正しいと保証してくれますか?

いいえ。diff を読み、bash -n で構文を確認し、実際のデータに触れる前に自分のマシンでスクリプトをテストしてください。エージェントが書くのは下書きで、Shell のカードには本物の終了コードが出ますが、スクリプトが正しいかどうかを決めるのは、あなた自身の確認だけです。

はじめる

テスト用マシンでスクリプトを1つ試す

セットアップは約 34 MB です。Windows 10 または 11 にインストールし、スクリプトのフォルダを開いて、まず Plan only で始めましょう。エージェントに何かを実行させたくなったら Ask first に切り替えます。

Windows 版 TechRetriever をダウンロード ↗

TechRetriever を見てみる

すべてのページが 20 言語で用意されています。

エージェントがスクリプトでできること ↗ クラウド、ローカル、内蔵モデル ↗ スクリプト作成のステップ別ガイド ↗ ダウンロードとチェックサムの手順 ↗ 質問と回答 ↗ プライバシーとデータの扱い ↗