{"report":{"v":1,"package":"aiterm-mcp","version":"0.70.70","ranAt":"2026-11-16T11:26:21.970Z","install":{"ok":true,"bin":"aiterm-mcp","integrity":"sha512-oEFHedeEsOhwtZn5n4ZJno12s19xVwgQAqyMwTY8Ep71jy/8E8vyRMsFPh7XqXjk1MN1ozECGN2D2IBS1QqH6g==","deps":102,"scripts":[],"bins":["aiterm-mcp","aiterm-setup","aiterm-runtime-errors","aiterm-wait","aiterm-delivery-wake","aiterm-parent-delivery","aiterm-update","aiterm-idle-check","aiterm-resume-state","aiterm-remote-terminal","aiterm-transcript-read"],"license":"MIT","engines":"node >=18","repository":"git+https://github.com/kitepon/aiterm-mcp.git"},"start":{"ok":true,"ms":301,"serverName":"aiterm","serverVersion":"0.70.70","protocol":"2025-06-18"},"tools":[{"name":"diagnostics","description":"Factory 向け read-only 診断。安全な状態語彙だけを機械可読 JSON で返す（PTY 内容・認証情報・path・環境値は返さない）。2つ目のtextは親配送hook（Claude Code・Cursor）の登録状態で、caller_status が setup_required なら呼出元からのagent送信は拒否される。aiterm-setup を実行する。","params":["format"]},{"name":"pty_open","description":"ローカル永続端末（POSIXはtmux、Windows nativeはpsmux 3.3.8以上）を1個開き、session_id を返す。backend server常駐ゆえ本サーバや クライアントが再起動してもセッションは生存する。リモート操作は専用ツールにせず、開いた端末の中で pty_send(session_id, \"ssh host\") と打って入る。","params":["name","shell","env_vars","remote"]},{"name":"pty_send","description":"セッションへテキストを送る。通常PTYへは送信のみ（出力は pty_read で取得）。agent session（launcher起動）への送信はこのtoolだけで行い、子の状態はAitermが送る時点で見て振り分ける。子のturnが実行中なら各harness標準の操作で現在のturnへ差し込み（mode=agent_steer）、完了は差し込み後の作業の終わりに元の依頼への1回だけ届く。新しいevent_cursorと配送は作らない。それ以外は新しいturnとしてdispatchし（mode=agent_dispatch）、TUI の ready gate と submit 分離を通して即返り、receipt の event_cursor を返す。dispatch した子は投げっぱなしでよい＝親はここで待たない。Codex親とClaude Code親にはAitermが回答本文を自動配送する。parent_deliveryがある場合はwait起動も通常の回答回収も不要。親は作業を続けるかターンを終える。Cursor親にはparent_deliveryとwait_processが付く。作業を続ければ次のツール返りに回答が差し込まれ、ターンを終える前にwait_processを背景で起動するとidle中の完了でも起きられる。ポーリングとpty_read(agent_transcript:true)は不要。その他の親では、完了通知をreceiptの `wait_process.executable` と `wait_process.args` をそのまま親のターンを塞がない別プロセスAPIへ渡して受け、PowerShell 7のStart-Processだけは `windows_start_process_argument_list` を単一文字列として渡す。exit を完了通知として扱う（exit 0=done / 3=timeout（既定600秒・未完了） / 4=closed / 7=error（harnessの記録でturnがAPIエラー等で打ち切られた。結果は無い）。receiptのoutcomeが正で、done以外は未完了。ポーリング不要）。`wait_command` は人間向け互換表示でありprocess境界へ使わない。foreground実行で親のターンを塞がない。自動配送以外の結果回収は pty_read(agent_transcript:true)、Claude の durable turn は claude_turn を使う。require_agent:true はagent登録が無いsessionへ打鍵せず、AGENT_SESSION_REQUIREDで未送信を返す。preface はagent sessionへの送信で本文の前に置く1行。Claude Codeの席では貼り付けの印なしで入れ、本文だけを貼る（前置きが貼り付けの包みの外へ出る）。他のharnessでは前置き・空行・本文を1つで貼る。force:true は非Claude agent sessionへの手動介入用の素送信。aiterm相関付きClaudeの承認UIはclaude_approvalを使う。","params":["session_id","text","enter","mark","force","require_agent","preface","rtk","raw","image","remote"]},{"name":"pty_read","description":"セッションの出力をトークン削減して読む（既定は前回読取位置からの増分）。削減: 制御文字除去 / 反復圧縮 / head+tail 折りたたみ＋復元ヒント＋メタ併記。agent_transcript:true は agent session の直近完了ターンの最終 assistant メッセージを公開されたharness記録から平文で返す。回答が空で終わったターンは誤りにせず、空のtextとanswer_empty:trueを返す。長い回答が screen tail で切れた時の回収用。","params":["session_id","wait","until","until_regex","timeout","screen","full","lines","line_range","raw","rtk","agent_transcript","operation_id","input_id","remote"]},{"name":"pty_key","description":"制御キーを送る（C-c, C-d, Enter, Tab, Up, Down... の別名に対応）。acceptedは入力受付であり処理中断/会話維持の確認ではない。aiterm相関付きClaudeではC-cだけを許可し、承認UIはclaude_approvalで操作する。","params":["session_id","key","remote"]},{"name":"pty_close","description":"セッションを閉じ、ログ／読取位置を破棄する。同じsession_idへの再試行は安全で、closed／already_closedのstructured receiptを返す。hibernate:trueはClaude・Codexのagent席を今すぐ休止し（idle時計と同じ手順）、会話と再開情報を残してhibernatedを返す。次のagent_launch（session_name）が同じ会話へ、保存した設定（起動時のmodel等。席の中で替えた物は持ち越さない）で再開する。turn・子process・子への配送が動いている間はAGENT_BUSYで断る（終わってから呼び直す）。Claudeの席が利用上限でturnを終えている時（最後の入力の後の会話記録がrate_limited）は、上限の待ち画面のままでも休止できる。他の理由で休止できない時はAGENT_HIBERNATE_UNAVAILABLE、席は触らない。","params":["session_id","hibernate","remote"]},{"name":"pty_list","description":"握っているセッション一覧（名前 / 現在の前面コマンド / attach 状態 / サイズ / agent 情報）。","params":["env_keys","remote"]},{"name":"pty_observe","description":"指定sessionの存在、paneとharnessの生存、状態と理由、native process identity、画面変化とCPU活動を構造化して観測する。画面本文と生argvは返さない。","params":["session_id","cursor","remote"]},{"name":"agent_approval","description":"Codexの現在の承認をinspectし、digestへ束縛した単発許可または拒否をrespondする。恒久許可は選ばない。Claudeは既存claude_approvalを使う。未知dialogはblockedのtyped errorで返す。","params":["action","session_id","approval_choice","observed_prompt_digest","remote"]},{"name":"claude_turn","description":"aiterm相関付きClaude sessionのdurable operationを構造化issue／recoverするmachine-caller専用面。pending／unknown／completedを人間向けerror文字列の解析なしで返し、Observer固有ロジックは持たない。","params":["action","session_id","operation_id","text","remote"]},{"name":"claude_approval","description":"aiterm相関付きClaudeのactive turn中に表示された権限確認UIを、turn相関を保ったまま検査・応答する専用面。inspectで画面digestと安全な単発Yes/Noだけを取得し、respondは同じoperation・同じdigestが現在も表示中の場合だけ送信する。","params":["action","session_id","operation_id","approval_choice","observed_prompt_digest","remote"]},{"name":"agent_auth","description":"各harnessの公式CLI認証を開始・確認・取消する。CLIごとのコマンドと認証URL/codeの抽出はAitermが所有し、資格情報は各CLIだけが保存する。auth_uiの段階と公式URL・選択肢を表示する。入力はrespondで同じbindingへ送り、pty_send／pty_keyへ認証コードを渡さない。authenticatedは認証の結果であり、agent_launchの起動準備完了とは別。remoteは他toolと同じ標準対応。startは公式の状態が認証済みなら何も起こさずauthenticatedを返す。relogin:trueを付けると、認証済みに見えても公式ログインを開始する（別のアカウントへ入り直す時、ログインの期限切れを状態から見抜けない時）。Aitermは資格情報を消さず、置き換えは公式CLIが行う。Codexの公式ログインは、始めた時点で元のログインを消す（途中でcancelしても戻らない）。Antigravityのreloginは未対応を返す。","params":["harness","action","expected_binding","expected_prompt_digest","response","session_id","cwd","env_vars","relogin","configuration_root","login","token_file","remote"]},{"name":"agent_goal","description":"Read or manage the CLI's real goal for an exact session/launch. clear removes the goal without stopping its turn; resume requires a paused goal. Editing objective resets native usage accounting. User mutations require trusted host provenance. No goal store or worker is created.","params":["session_id","launch_id","action","expected_thread_id","objective","token_budget"]},{"name":"agent_configure","description":"起動済みのClaude／Codex／Grok／Cursor／Antigravity agent sessionを再起動せず、会話contextを保ったままmodel／reasoning effort／fastを変更する。各harnessのCLI標準model操作を使う。Cursorのreasoning_effort変更はmodelと同時指定する。Claude Codeの席では /model の選ぶ画面の「この会話だけ」（s）で替え、端末の ~/.claude/settings.json の既定は書き換えない。その選び方が無い版、選ぶ画面に無いmodel、そのmodelで選べないeffortは、何も変えずに断る。fastだけの指定も受ける。ファスト（harnessの高速の応答。費用や利用量が増える）。席は必ず通常の速度で起きる。trueはその席をfastへ切り替え、falseは通常の速度にする（fastに対応していないmodelでもfalseは受ける）。切り替えは席だけに留め、harnessが利用者の既定へ書いた分は切り替えの直前の値へ戻す。断りは文の先頭の符号で分かる: FAST_MODE_NOT_SUPPORTED（そのmodelは対応していない）、FAST_MODE_UNAVAILABLE（アカウントや契約で使えない）、FAST_MODE_MODEL_CONFLICT（modelへfast版のIDを書いてfalseを渡した）、FAST_MODE_UNCONFIRMED（切り替えた後の状態を確かめられない）。","params":["action","request","session_id","model","reasoning_effort","fast","remote"]},{"name":"agent_models","description":"harnessが今返すmodelとreasoning effortの候補を、そのharnessの公式の一覧から取得する。promptもturnも送らず推論を消費しない。Codexはapp-server model/list、Claude Codeはstream-json initializeのmodels、Grokはagent stdio initializeのmodelState、Cursorはcursor-agent modelsを素のmodel IDとeffortへ分けたもの。Antigravityはagy modelsのeffortを含むIDをそのまま返す。返るidとeffortsはagent_launch／agent_configureへそのまま渡せる。modelごとのfastは、そのmodelでfastへ切り替えられるか（harnessが返す値）。fast_unavailableは、アカウントの都合でどのmodelでも使えない時の訳。取得不能はMODEL_CATALOG_UNAVAILABLE、形式異常はMODEL_CATALOG_INVALIDのエラーで返し、別の一覧へfallbackしない。remoteを付けると別端末のharnessの候補を返す。","params":["harness","cwd","include_hidden","configuration_root","claude_login","remote"]},{"name":"agent_launch","description":"エージェントを単一の標準入口から永続sessionへ起動する。harnessはagent loop・認証・hook・transcriptを所有する実行基盤、modelはそのharnessが選ぶ推論モデルであり別軸。Cursor harnessからGPT／Claude／Grok等を選んでも完了相関はCursor方式のまま。ComposerはCursorのmodelの一つで、harnessでもGrokのmodelでもない。harness=cursor-cli と model=composer-2.5-fast（またはcomposer-2.5）で指定する。remoteを付けると、SSHで入った別端末のAitermで同じ起動を行い、完了は同じ形で親へ届く。通常CLIと同じHOME・cwd・project/user/local設定・MCP・plugin・skill・permission/trustを共有する。aitermは完了相関stateだけをlaunch単位で所有する。起動されたagentにはsub-agent自己認識、親session、delegation depth/lineage、delegation_allowed=trueを注入し、必要な追加委譲は許可する。別のcomputer（登録済みの端末）で起こす時は、この起動にterminal（端末の登録元が渡す値をそのまま）とcwd（その端末のproject folder）を付ける。ここで起こしてからcd・sshしない。秘密の値はどの引数・prompt・送信文にも書かず、env_varsに名前だけを書く。dispatch した子は投げっぱなしでよい＝親はここで待たない。Codex親とClaude Code親にはAitermが回答本文を自動配送する。parent_deliveryがある場合はwait起動も通常の回答回収も不要。親は作業を続けるかターンを終える。Cursor親にはparent_deliveryとwait_processが付く。作業を続ければ次のツール返りに回答が差し込まれ、ターンを終える前にwait_processを背景で起動するとidle中の完了でも起きられる。ポーリングとpty_read(agent_transcript:true)は不要。その他の親では、完了通知をreceiptの `wait_process.executable` と `wait_process.args` をそのまま親のターンを塞がない別プロセスAPIへ渡して受け、PowerShell 7のStart-Processだけは `windows_start_process_argument_list` を単一文字列として渡す。exit を完了通知として扱う（exit 0=done / 3=timeout（既定600秒・未完了） / 4=closed / 7=error（harnessの記録でturnがAPIエラー等で打ち切られた。結果は無い）。receiptのoutcomeが正で、done以外は未完了。ポーリング不要）。`wait_command` は人間向け互換表示でありprocess境界へ使わない。foreground実行で親のターンを塞がない。自動配送以外の結果回収は pty_read(agent_transcript:true)。","params":["require_existing_resume","configuration_root","harness","prompt","image","throughline_source_session","throughline_supplement_file","model","reasoning_effort","fast","env_vars","trust_project","cwd","session_name","write_scope","launch_operation_id","remote","terminal","append_system_prompt","mcp_config","fork_from"]},{"name":"claude_agent","description":"【旧互換alias。新規連携は agent_launch(harness=claude-code)】Claude Codeの対話エージェントTUIを永続端末に起動する。`claude -p`ではなく、同じ利用者可視sessionへpty_sendで継続入力する。通常CLIと同じHOME・cwd・project/user/local設定・MCP・plugin・skill・permission/trustを共有する。aitermは完了相関stateだけをlaunch単位で所有する。起動されたagentにはsub-agent自己認識、親session、delegation depth/lineage、delegation_allowed=trueを注入し、必要な追加委譲は許可する。別のcomputer（登録済みの端末）で起こす時は、この起動にterminal（端末の登録元が渡す値をそのまま）とcwd（その端末のproject folder）を付ける。ここで起こしてからcd・sshしない。秘密の値はどの引数・prompt・送信文にも書かず、env_varsに名前だけを書く。通常settingsへlaunch固有Stop hook settingsを加算する。起動前に共有認証を構造化確認し、未認証ならsessionを作らない。dispatch した子は投げっぱなしでよい＝親はここで待たない。Codex親とClaude Code親にはAitermが回答本文を自動配送する。parent_deliveryがある場合はwait起動も通常の回答回収も不要。親は作業を続けるかターンを終える。Cursor親にはparent_deliveryとwait_processが付く。作業を続ければ次のツール返りに回答が差し込まれ、ターンを終える前にwait_processを背景で起動するとidle中の完了でも起きられる。ポーリングとpty_read(agent_transcript:true)は不要。その他の親では、完了通知をreceiptの `wait_process.executable` と `wait_process.args` をそのまま親のターンを塞がない別プロセスAPIへ渡して受け、PowerShell 7のStart-Processだけは `windows_start_process_argument_list` を単一文字列として渡す。exit を完了通知として扱う（exit 0=done / 3=timeout（既定600秒・未完了） / 4=closed / 7=error（harnessの記録でturnがAPIエラー等で打ち切られた。結果は無い）。receiptのoutcomeが正で、done以外は未完了。ポーリング不要）。`wait_command` は人間向け互換表示でありprocess境界へ使わない。foreground実行で親のターンを塞がない。自動配送以外の結果回収は pty_read(agent_transcript:true)。Claude の durable turn は claude_turn でも回収できる。","params":["prompt","throughline_source_session","throughline_supplement_file","model","reasoning_effort","fast","env_vars","trust_project","cwd","terminal","session_name","append_system_prompt","mcp_config","configuration_root","launch_operation_id"]},{"name":"codex_agent","description":"【旧互換alias。新規連携は agent_launch(harness=codex-cli)】Codexの対話エージェント TUI を永続端末に起動する。実装・レビュー・調査を対話で回す。通常CLIと同じHOME・cwd・project/user/local設定・MCP・plugin・skill・permission/trustを共有する。aitermは完了相関stateだけをlaunch単位で所有する。起動されたagentにはsub-agent自己認識、親session、delegation depth/lineage、delegation_allowed=trueを注入し、必要な追加委譲は許可する。別のcomputer（登録済みの端末）で起こす時は、この起動にterminal（端末の登録元が渡す値をそのまま）とcwd（その端末のproject folder）を付ける。ここで起こしてからcd・sshしない。秘密の値はどの引数・prompt・送信文にも書かず、env_varsに名前だけを書く。委譲契約を使う完全な呼び出し例: `codex_agent({\"prompt\":\"<依頼>\",\"model\":\"gpt-5.6-sol\",\"reasoning_effort\":\"high\",\"cwd\":\"/absolute/path/to/repo\",\"write_scope\":\"read-only\"})`。turn は pty_send で送る（自動で非ブロック dispatch になる）。dispatch した子は投げっぱなしでよい＝親はここで待たない。Codex親とClaude Code親にはAitermが回答本文を自動配送する。parent_deliveryがある場合はwait起動も通常の回答回収も不要。親は作業を続けるかターンを終える。Cursor親にはparent_deliveryとwait_processが付く。作業を続ければ次のツール返りに回答が差し込まれ、ターンを終える前にwait_processを背景で起動するとidle中の完了でも起きられる。ポーリングとpty_read(agent_transcript:true)は不要。その他の親では、完了通知をreceiptの `wait_process.executable` と `wait_process.args` をそのまま親のターンを塞がない別プロセスAPIへ渡して受け、PowerShell 7のStart-Processだけは `windows_start_process_argument_list` を単一文字列として渡す。exit を完了通知として扱う（exit 0=done / 3=timeout（既定600秒・未完了） / 4=closed / 7=error（harnessの記録でturnがAPIエラー等で打ち切られた。結果は無い）。receiptのoutcomeが正で、done以外は未完了。ポーリング不要）。`wait_command` は人間向け互換表示でありprocess境界へ使わない。foreground実行で親のターンを塞がない。自動配送以外の結果回収は pty_read(agent_transcript:true)。model / reasoning_effort を引数で指定可（省略時は端末 config／CLI 既定を継承。実効値は起動応答に明示）。","params":["prompt","throughline_source_session","throughline_supplement_file","model","reasoning_effort","fast","env_vars","trust_project","cwd","terminal","session_name","write_scope"]},{"name":"grok_agent","description":"【旧互換alias。新規連携は agent_launch(harness=grok-cli)】Grok BuildのGrokモデル（既定 grok-4.6）の対話エージェント TUIを永続端末に起動する。通常CLIと同じHOME・cwd・project/user/local設定・MCP・plugin・skill・permission/trustを共有する。aitermは完了相関stateだけをlaunch単位で所有する。起動されたagentにはsub-agent自己認識、親session、delegation depth/lineage、delegation_allowed=trueを注入し、必要な追加委譲は許可する。別のcomputer（登録済みの端末）で起こす時は、この起動にterminal（端末の登録元が渡す値をそのまま）とcwd（その端末のproject folder）を付ける。ここで起こしてからcd・sshしない。秘密の値はどの引数・prompt・送信文にも書かず、env_varsに名前だけを書く。turn は pty_send で送る（自動で非ブロック dispatch になる）。dispatch した子は投げっぱなしでよい＝親はここで待たない。Codex親とClaude Code親にはAitermが回答本文を自動配送する。parent_deliveryがある場合はwait起動も通常の回答回収も不要。親は作業を続けるかターンを終える。Cursor親にはparent_deliveryとwait_processが付く。作業を続ければ次のツール返りに回答が差し込まれ、ターンを終える前にwait_processを背景で起動するとidle中の完了でも起きられる。ポーリングとpty_read(agent_transcript:true)は不要。その他の親では、完了通知をreceiptの `wait_process.executable` と `wait_process.args` をそのまま親のターンを塞がない別プロセスAPIへ渡して受け、PowerShell 7のStart-Processだけは `windows_start_process_argument_list` を単一文字列として渡す。exit を完了通知として扱う（exit 0=done / 3=timeout（既定600秒・未完了） / 4=closed / 7=error（harnessの記録でturnがAPIエラー等で打ち切られた。結果は無い）。receiptのoutcomeが正で、done以外は未完了。ポーリング不要）。`wait_command` は人間向け互換表示でありprocess境界へ使わない。foreground実行で親のターンを塞がない。自動配送以外の結果回収は pty_read(agent_transcript:true)。model／reasoning_effortを引数で指定可。read-only sandboxとagent_configureに対応。","params":["prompt","throughline_source_session","throughline_supplement_file","model","reasoning_effort","fast","env_vars","trust_project","cwd","terminal","session_name","write_scope"]}],"toolsHash":"11c5cfcd3b2d4855ee2be3063278c0b9c3f27534992237461687f680f472745d","wrote":[],"callsAt":"2026-11-16T11:26:33.481Z","calls":[{"tool":"pty_list","ok":false,"ms":12,"bytes":0,"error":"tool reported an error: aiterm: tmux が見つかりません（PATH 上に存在しません）。aiterm は実行時に tmux を必要とします。（例: Debian/Ubuntu は `sudo apt install tmux`）。別の場所にある tmux を使うには AITERM_TMUX=/path/to/tmux を指定してください。"}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":19,"wrote":0,"callsTried":1,"callsAnswered":0,"callContacts":[]},"history":[{"package":"aiterm-mcp","version":"0.70.70","ranAt":"2026-11-16T11:26:21.970Z","outcome":"started","tools":19,"contacts":0,"flags":0,"serious":0,"toolsHash":"11c5cfcd3b2d4855ee2be3063278c0b9c3f27534992237461687f680f472745d"},{"package":"aiterm-mcp","version":"0.70.39","ranAt":"2026-11-12T17:48:18.108Z","outcome":"started","tools":19,"contacts":0,"flags":0,"serious":0,"toolsHash":"71fe0037e2b16a7571c296404d2bb94ea600f4313e2354eb96d161edaf7bb1d7"}],"page":"https://bragproof.smaverk.com/r/aiterm-mcp"}