手引き
姿で、変えたところは設定画面に出ます。
翻訳は同じ場所に docs/MANUAL.<コード>.md として置きます。歯車の隣の ? は、
使っている言語の手引きを開きます。
1. 画面に何があるか
Section titled “1. 画面に何があるか”INDEX は盤面です。全タブの一覧と、それぞれが何をしているか、文字1つで選ぶ
メニューが並びます。どこからでも Ctrl+B 0 で戻れます。
左の一覧がタブバーです。上から順に:
- デスク — いちばん上の名前。押すと別のデスクに切り替えます。
- プロジェクト — プロジェクトごとの見出し（色と名前）と、その下に並ぶ作業フォルダ。
見出しの
+で、そのプロジェクトのワークツリー（並行開発）を作ります。▾ でプロジェクト ごと畳みます。 - 作業フォルダ — 見出しの下のカード。状態の点と名前、2行目に乗っているブランチが 出ます。元のチェックアウトには「プライマリ」の札が付き、ワークツリーはその下に並びます。 カードの下に、そのフォルダで働くタブが並びます。フォルダのカードもタブも、右クリックの 名前を変更でその場で名前を書き換え（欄から離れると保存）、編集で設定のページを開きます。 ワークツリーのカードには、いちばん下に赤い完全削除があります。フォルダごと削除し、 リンクは先に解除するのでリンク先は残ります。コピーした git の管理外ファイルも一緒に消えます。 まだコミットしていない変更があるときは削除しません。確認で「二度と表示しない」を選ぶと 次からすぐ削除します（戻すときは「設定 > 基本 > ワークツリーの削除」）。
- タブ — 番号と名前と点。緑は作業中、青は答え終わり、黄はあなたの 返事待ちです。名前の下に、乗っているブランチ・プルリクエスト・開いているポート、 その下に、そのタブが最後に言ったことが出ます。
- INDEX と Issue の下に PROJECT の見出しと、その右端の
+（プロジェクトを追加）。 いちばん下に歯車（設定）、?（このページ）、💡（アイデア）、ハサミ（便利ツール）、🎛️（クイックコマンド）。
クイックコマンドは、自分で作るボタンの格子です。🎛️ か Ctrl+Shift+K で画面いっぱいに
出ます。ボタンを押すと、見ているタブのフォルダに毎回新しいタブが開きます。コマンドは
新しいシェルタブで実行し、プロンプトは新しく起動した AI に渡します。
フォルダが無いときは、コマンドはホームフォルダで開き（アプリの起動にも使えます）、
プロンプトは送りません。ボタンの下の1行が、押すとどこへ送るかを先に言います。
作る・並べ替える・フォルダにまとめるのは、設定の「クイックコマンド」です。
本文に書いた秘密情報の名前は、送るときに、見ているデスクの秘密情報の値に置き換わります。
真ん中は見ているタブです。端末か、ブラウザのページか、git パネル。画面を分割 したあとは、各ペインの見出しの ▥ ▤ でさらに割る、✕ でそのペインを閉じる、です。
真ん中の上には、見ているフォルダのタブが横に並びます。押すと切り替わり、+ で
タブを足します。タブの ✕ かホイールクリックで、そのタブを閉じます。✕ は見ているタブと、
マウスを乗せたタブに出ます。AI が作業中か返事待ちのときだけ、止めてよいか確認します。
閉じたタブは、並びの右端の ▾ から開き直せます。AI の会話を名前で再開できる CLI
（Claude Code・Codex）なら、会話ごと戻ります。画面に出ていた文字は戻りません。
入力欄の上の帯は便利バーです。1回押すと、見ている AI に決まった指示（続けて・ 説明・レビュー・修正）を送ります。左端の小さな切替で、帯に何を載せるかを選べます。 決まった指示、自分で作ったアクション、マクロの記録、git、AI によるコマンド提案、 別のタブを操作する対象、です。
いちばん下の入力欄は、見ているタブへ打つ場所です。スマホでは、ここが唯一の 入力口です。
最下段の帯には、いまのデスク名、自動化が ON か、スマホがつながっているか、 ビルド、そして受け渡しと作業中の AI を一斉に止める停止ボタンが並びます。見ているタブの AI が 自分の利用上限について何か言っていれば、その行もここに出ます。押すと消えます。
接頭キーは Ctrl+B です（tmux 風）。キーはすべて設定で変えられるので、Ctrl+B ? が
いま実際に効いているキーを出します。
接頭キーの要らないキーもあります。Ctrl+Shift+K でクイックコマンド、Ctrl+Shift+M で
アイデアが開きます。入力欄にカーソルがあるときも効きます。「全体設定 > キー」で操作の横の
欄を選び、使いたい組み合わせ（Ctrl+Shift+D、Alt+F4、F5）を押すと、その操作に
自分のキーを付けられます。
| キー | 何をするか |
|---|---|
Ctrl+B q |
終了 |
Ctrl+B 0〜9 |
タブ切替（0 = INDEX） |
Ctrl+B n / Ctrl+B p |
次のタブ / 前のタブ |
Ctrl+B t |
タブを追加 |
Ctrl+B & |
このタブを閉じる（AI が作業中なら確認します） |
Ctrl+B T |
最後に閉じたタブを開き直す |
Ctrl+B r / Ctrl+B R |
このタブを会話ごと再開 / 最初から起動し直す |
Ctrl+B % / Ctrl+B " |
画面を横に割る / 縦に割る |
Ctrl+B o |
次のペインへ |
Ctrl+B X |
このペインを閉じる（タブは動いたまま） |
Ctrl+B = |
仕切りを半々に戻す |
Ctrl+B < / Ctrl+B > |
仕切りを左・上へ / 右・下へ |
Ctrl+B s |
タブバーをしまう・出す |
Ctrl+B g |
変更したファイルを右に出す・しまう |
Ctrl+B w / Ctrl+B W |
デスク一覧 / 次のデスク |
Ctrl+B [ |
コピーモード（/ で検索、n・N で次と前） |
Ctrl+B c |
直近の回答をコピー |
Ctrl+B l |
このタブの入力をロック |
Ctrl+B a |
自動化の ON/OFF |
Ctrl+B x |
緊急停止 |
Ctrl+B b |
接頭キーそのものをプログラムに送る |
Ctrl+B : |
コマンドパレット |
Ctrl+B k |
クイックコマンド |
Ctrl+B m |
アイデア |
Ctrl+B ? |
キー一覧 |
INDEX のメニューは文字1つです。e 設定、p パレット、f 作業を探す、i スマホ用の
QR コード、r 終了したタブを再起動、w デスク切替、t 通知テスト、
k マスターパスワード、? ヘルプ。
マウスでも操作できます。ホイールでスクロール、Ctrl+ホイールで端末の文字の大きさ、 ドラッグでコピー、右クリックで貼り付け、タブ名クリックで切替。ペインの仕切りは ドラッグで動かせて、ダブルクリックで半々に戻ります。タブバーは右端をドラッグすれば 幅が変わり、ダブルクリックで既定の幅、左端まで詰めるとしまわれて画面が全部端末に なります。
3. 作業フォルダと枝
Section titled “3. 作業フォルダと枝”PROJECT の見出しの右端にあるフォルダ＋を押すと、プロジェクトを追加します。この PC の フォルダを開くか、URL からクローンするか、新しく作るかを選べます。追加したプロジェクトは、 設定 → 基本 → デフォルトのコマンド（PowerShell・コマンドプロンプト・Git Bash。既定は PowerShell）が 開いた状態で始まります。タブを閉じて空になったフォルダは、押すとまたそれが開きます。
SSH で入るサーバーのプロジェクトも同じダイアログから足せます。「SSH ホストのプロジェクト」で
名前・ホスト・ユーザー・ポート・鍵ファイルを入れるか、~/.ssh/config の別名から埋めます。ホストが
あると、ダイアログの一番上の場所でこの PC かホストかを選べます。ホストでは、フォルダを
たどって追加するか、URL からそのホストの上でクローンします。git と端末はホストの上で動きます。
同じプロジェクトの別ブランチを同時に動かすには、見出しの + を押します。
ワークツリーを作成するダイアログが開きます。
- プロジェクト — どのプロジェクトから作るか
- 名前または「作成元」 — 4つのタブで決めます。開いたときの 自動 は何も打ち込みません。 AIへの依頼内容から名前と概要が付きます（下記）。GitHub はそのプロジェクトの Issue と プルリクエストを探して選ぶと、名前が付き、作業がその Issue に結び付きます（プルリクエストは そのブランチを取ってきます）。ブランチは何から切るかを一覧から選びます。名前は 打ち込みます。打ち込んだ名前はそのまま残り、空のままなら自動になります
- AI — 新しいフォルダで何を動かすか。既定は 設定 → 基本 → アシスタントAI
- 詳細設定 — AI ごとに1つ作る、置き場所、git が運ばないもの（
.envやnode_modules）を 持って行くか、実行されるgit worktree addの行そのもの
ワークツリーを作成する（Ctrl+Enter）を押すと、プロジェクトの見出しの下に
「作っています…」の行が出て、出来るとその場でフォルダのカードに替わります。行の ✕ で止めると、
作りかけのフォルダと新しいブランチは消えます。失敗したら理由が出て、もう一度か閉じるを
選べます。作ったフォルダは ~SHIKISHA-TERMranches<プロジェクト><名前> にあります。
依頼内容から付く名前。 「自動」がオンの作業フォルダ（設定 → その作業フォルダ → 自動。 ダイアログで作ったワークツリーは最初からオン）は、そこでAIに送った依頼をもとに、AIが名前と 概要を付けます。最初の依頼のあとすぐ付き、その後はそこのAIが作業を終えたときに付け直します （10分に1回まで）。送るのは依頼の文だけで、AIの返事は送りません。依頼に貼った長いコードは 省きます。付くまでは一覧にブランチ名が出て、自動で付いた名前は少し暗い色で出ます。一覧で フォルダにポインタを乗せると名前と概要が出ます。スマホではカードに概要が1行出て、カードを 長押しすると、メニューの一番上に概要の全文が出ます。名前か概要を手で書き換えると自動は 外れます。使うAIはデスクごとに、設定 → デスク → 自動の名前 で選べます（いちばん軽い聞き方で 聞くアシスタントAIか、デスクのモデル接続先）。
ターミナルやほかの道具で作ったワークツリーは、見出しの下に「N 個の見つかったワークツリーを 隠しています」と出ます。開いてワークツリーリストに表示するか、✕ で隠したままにします。
この PC に無いフォルダ（別の PC から持ってきた設定）は一覧でそう言います。押すと、 戻すのに何をするかを示し、言えばそのとおりにします。
4. スマホから
Section titled “4. スマホから”設定でスマホからの利用を ON にして、QR コードを読みます。全タブとその状態、返事を 書く欄がスマホに出ます。PC でできることはスマホからもできます。準備の3段階は スマホから使う にあります。
ページをどちらで描くか。 AI がブラウザのページを開いたとき、この機械で描くか、
つないだ端末（窓やスマホ）で描くかを選べます（設定 → ページを描く場所）。既定はこの機械です
——スマホからも見られ、誰もつないでいなくても動き続け、ログインが全端末で1つだからです。
どちらを選んでもページの通信はこの機械から出ます。この機械で立てた localhost:3000 は、
どちらの側から見ても同じものです。
5. サーバーにつなぐ
Section titled “5. サーバーにつなぐ”タブの「種類」で サーバー（このソフトで接続） を選び、接続先・ポート・ユーザーを入れて、
パスワードを保存します。パスワードは二度と画面に出ず、user@host's password: のような
入力待ちも出ません。開くと、そのサーバーの端末がそのままタブになります。
自動化からは、そのタブの名前を書けばファイルも読み書きできます（sftp_ls / sftp_get /
sftp_put など。自動化リファレンス）。
画面からも同じことができます。 タブを追加して、種類を「サーバーのファイル（SFTP）」にします。
アドレス・入る人・鍵は、種類のすぐ下、そのタブの設定にあります（サーバーの端末とまったく同じ欄です）。
入れると、左にこのPCのフォルダ、右にそのサーバーのフォルダが出ます。選んで「送る」「取り込む」、
右端の ⋯ で新しいフォルダ・名前を変える・消す。スマホでは、上の「この PC / サーバー」で片側ずつ見ます。
本番と検証を見分ける。 接続の設定の「このサーバーの名前」に「本番」「検証」などと入れ、色を選びます。 名前はタブではなくサーバーに付くので、同じサーバーにつなぐタブ（端末もファイルも）すべてに、 色の四角と名前の札が出ます。ファイルを消す・名前を変える・置き換えるときの確認にも出ます。 踏み台越しのサーバーは、踏み台ごとに別のサーバーです。「取り消せない操作の前に、この名前の入力を求める」を 入れると、そういう操作はその名前を打つまで実行しません。付けた名前は、設定の「サーバーの名前」に並びます。
サーバーの鍵が前回と違うときは、つなぎません。 サーバーを入れ直したのなら、
data/known-hosts.json からその行を消してください。
ssh コマンドを直接打つタブも今までどおり作れます（種類は「SSH (ssh.exe)」）。
6. パスワードやトークンの置き場所
Section titled “6. パスワードやトークンの置き場所”デスクの設定の 秘密情報 に登録します。自動化からは短い名前で呼び、値そのものは スクリプトにも AI にも渡りません。登録するときに2つ決めます。
- 秘密の利用を許可するURL — このパスワードを入力してよいページ。書いたURL以外では入りません。
https://example.comはそのサイトの全ページ、https://example.com/apiは/apiで始まるページだけ、https://*.example.comは example.com とサブドメイン全部 - 利用権限 — 自動化から使えるのは誰か。人間とAIの2つで、はじめは人間だけです。 AI が動かしたスクリプトにも使わせたいときは AI を入れます。AI だけを入れれば、 AI のおつかい専用の鍵になります
一覧・変更・削除は、どれもそのデスクの設定の 秘密情報 で行います。 行を押すと開きます。
7. 自動化
Section titled “7. 自動化”タブが答え終わったとき、質問してきたとき、静かになったときに何をするか。答えを 別のタブへ渡す、確認に答える、通知を送る。Lua で数行書くか、言葉で書いて手持ちの AI に書いてもらいます。自動化リファレンス を見てください。
8. 困ったとき
Section titled “8. 困ったとき”- 設定を変えたら起動しなくなった — プログラムの隣の
Settings.cmdをダブル クリックしてください。設定画面だけが開くので、そこで変更を戻せます。 - フォルダが「この PC にない」と出る — 見出しを押してください。取ってくる・ ブランチを作る、の手順が出て、言えばそのとおりに実行します。
- 作業中のはずなのに何も動かない —
Ctrl+B rで会話ごと再起動、Ctrl+B Rで 新しい会話から起動し直します。 - 受け渡しが暴走した — 最下段の停止ボタンか
Ctrl+B xで、受け渡しを一斉に 止め、作業中の AI にも中断を送ります（そのタブで押すのと同じ Esc や Ctrl+C。 どのキーかはプロファイルに書いてあります）。Ctrl+B aで ON にするまで 自動化は止まったままです。 - 何が起きたか知りたい — プログラムの隣の
logs\hooks.logに、状態の変化と 自動化の実行が、起動からの秒数つきで残っています。 - zip を初めて起動したら Windows の警告が出た — zip にはコード署名が付いて いません（Store 版には付いています）。理由と、落としたものの確かめ方。
起動時に一度と、動いている間は1日に一度、新しい版が出ていないかを見に行きます。 出ていれば、サイドバーに小さな札が一度だけ出ます。札の2つのボタンは何も入れません。 更新を開く は設定の「更新」へ、今回はいい はその版について札をしまうだけです。
版を入れる場所は設定の「更新」の1か所だけで、札から来ても自分で来ても同じボタンを 押します。落として入れる を押すと、zip を落とし、公開されている SHA256 と署名で 確かめてから、AI が作業中なら終了時と同じ確認をして、ファイルを入れ替えて起動し直し ます。設定・data・logs・desks・scripts には触りません。新しい版の最初の起動では、 先に設定の写しを取ります。入れ替える前の版は残してあり、同じカードの 戻す で 戻せます。Store 版では同じボタンが Store に入れさせ、Store が再起動します。
何版か飛ばしましたか。最新の版が設定を1版ずつ順に引き継ぐので、間の版を入れる必要は ありません。