Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

io.github.kitepon/aiterm-mcp

NPM · AITERM-MCP

Persistent terminals and one launcher for Claude, Codex, Grok, Cursor, and Antigravity harnesses.

Available components

+1 this week 88 Trust /100

Last scanned (1 hour ago)

Scores higher than 92% of npm servers

Category Developer Tools

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security98
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • No install/post-install scripts declared.Pass
  • 30 of 99 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency100
  • Source repository is publicly reachable at the declared URL. View diagnostics → Pass
  • Cryptographically verified build provenance (signed, bound to kitepon/aiterm-mcp). View diagnostics → Pass
  • Clear OSI-approved license (MIT).Pass
  • Actively maintained (last published 1 days ago).Pass
  • Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability50
  • AI-judged instruction clarity (good).Pass
  • Context-footprint check failed: tool/resource definitions use about 10065 tokens (~529/item across 19 items; 19 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
  • No destabilizing schema changes in the last 30 days.Pass
Tool Coverage94
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 79% of tool parameters carry a description.Partial
  • Structured output schemas are declared (84% of tools); any adoption earns full credit.Pass
Tool Safety75
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • 0 of 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "pty_send" implies "send" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
  • An AI judge read all 19 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 4 Nov 26 +25
    • Malware scan: unverified → pass ▲ security
    • Known CVEs: unverified → pass ▲ security
    • Dependency health: unverified → 0.87 ▲ functional
  • 3 Nov 26 −11
    • Known CVEs: pass → unverified ▼ security
    • Malware scan: unverified → pass ▲ security
    • Dependency health: 0.87 → unverified ▼ functional
    • Package version: 0.63.3 → 0.63.7 functional
    • Package version: 0.63.3 → 0.63.6 functional
    • Package version: 0.63.3 → 0.63.5 functional
  • 2 Nov 26 −15
    • Known CVEs: pass → unverified ▼ security
    • Malware scan: pass → unverified ▼ security
    • Dependency health: 0.87 → unverified ▼ functional
    • Security disclosure: pass → unverified ▼ functional
    • Package version: 0.63.0 → 0.63.3 functional
    • Package version: 0.63.0 → 0.63.2 functional
    • Package version: 0.63.0 → 0.63.1 functional
  • 1 Nov 26 +17
    • Stability: fail → unverified ▼ security
    • Known CVEs: pass → unverified ▼ security
    • Tool safety: pass → unverified ▼ security
    • Malware scan: unverified → pass ▲ security
    • Stability: fail → pass ▲ security
    • Capabilities: pass → unverified ▼ functional
    • Dependency health: 0.87 → unverified ▼ functional
    • Tool coverage: 100 → unverified ▼ functional
    • Package version: 0.62.3 → 0.63.0 functional
    • Package version: 0.62.3 → 0.62.6 functional
    • Package version: 0.62.3 → 0.62.4 functional
  • 31 Oct 26 −15
    • Malware scan: pass → unverified ▼ security
    • Package version: 0.62.2 → 0.62.3 functional
  • 30 Oct 26 0
    • Known CVEs: pass → unverified ▼ security
    • Dependency health: 0.87 → unverified ▼ functional
    • Package version: 0.61.24 → 0.62.2 functional
    • Package version: 0.61.24 → 0.62.1 functional
    • Package version: 0.61.24 → 0.62.0 functional
  • 29 Oct 26 +15
    • Malware scan: unverified → pass ▲ security
  • 28 Oct 26 −15
    • Malware scan: pass → unverified ▼ security
    • Known CVEs: pass → unverified ▼ security
    • Dependency health: 0.87 → unverified ▼ functional
    • Package version: 0.61.21 → 0.61.24 functional
    • Package version: 0.61.21 → 0.61.23 functional
    • Package version: 0.61.21 → 0.61.22 functional
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 5 Nov 2026 · Analysed npm/aiterm-mcp@0.63.7

Provenance Verified

A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.

Result Verified
Ecosystem npm
Reason Verified
Discovered via Registry attestation endpoint
Source repo kitepon/aiterm-mcp
Certificate issuer https://token.actions.githubusercontent.com
Certificate SAN https://github.com/kitepon/aiterm-mcp/.github/workflows/ci.yml@refs/tags/v0.63.7
Rekor log index 3670009043
Predicate type SLSA build provenance https://slsa.dev/provenance/v1
Subject digest sha512:813202e2fa5254a36dde2e5c88151cf266db117c8202705f0735a97cbe90d48f53c1ee45f7cc5757379e8571ba56f2b4781508b64d9b661d1357248a8

Background: How many MCP packages publish verified provenance →

Dependencies 99 packages
Packages resolved 99
Stale 30
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 19 exposed · ~10,065 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
agent_approval ~185

Codexの現在の承認をinspectし、digestへ束縛した単発許可または拒否をrespondする。恒久許可は選ばない。Claudeは既存claude_approvalを使う。未知dialogはblockedのtyped errorで返す。

NameTypeReqDescription
actionstringyes–
approval_choicestring––
observed_prompt_digeststring––
remoteobject–別端末のAitermで実行する時のSSH接続情報。hostだけならssh_configの接続名として使う。Aitermは接続情報を保存・管理しない。passphraseは会話記録に残るため、ssh-agentかpassphrase_env(環境変数名)を推奨する。
session_idstringyes–
NameTypeReqDescription
actionstringyes–
atstringyes–
choicesarrayyes–
harnessstringyes–
kindstring|nullyes–
launch_idstringyes–
promptstring|nullyes–
prompt_digeststring|nullyes–
reasonstringyes–
schemastringyes–
selected_choice–yes–
session_idstringyes–
statusstringyes–

No examples provided.

agent_auth ~501

各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は未対応を返す。

NameTypeReqDescription
actionstringyes–
cwdstring–公式CLIを実行する作業ディレクトリの絶対パス
env_varsarray–startで認証PTYへ引き継ぐ環境変数名。値はreceiptへ返さない
expected_bindingobject––
expected_prompt_digeststring––
harnessstringyes–
reloginboolean–startで、公式の状態が認証済みでも公式ログインを開始する。既定false。trueの時、authenticatedかつsession_idがnullの結果は返さない
remoteobject–別端末のAitermで実行する時のSSH接続情報。hostだけならssh_configの接続名として使う。Aitermは接続情報を保存・管理しない。passphraseは会話記録に残るため、ssh-agentかpassphrase_env(環境変数名)を推奨する。
response–––
session_idstring––
NameTypeReqDescription
auth_uiobject––
harnessstringyes–
input_requiredbooleanyes–
messagestring|nullyes–
schemastringyes–
session_idstring|nullyes–
statusstringyes–
urlstring|nullyes–
user_codestring|nullyes–

No examples provided.

agent_configure ~621

起動済みの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(切り替えた後の状態を確かめられない)。

NameTypeReqDescription
actionstring–省略は従来apply。reconcileはrequestへ固定した保存結果だけを読み、入力や再適用を行わない
fastboolean|null–変更後のfast。省略時は、その席の今の状態を変えない
model––変更後のmodel。省略時はmodelを変更しない
reasoning_effort––変更後のreasoning effort。省略時はeffortを変更しない
remoteobject–別端末のAitermで実行する時のSSH接続情報。hostだけならssh_configの接続名として使う。Aitermは接続情報を保存・管理しない。passphraseは会話記録に残るため、ssh-agentかpassphrase_env(環境変数名)を推奨する。
requestobject–追跡する新規apply/reconcileの原要求。idは初回発行前に保存するUUID、launch_idは期待世代、digestは正規化した要求値のSHA256。旧事故への後付け不可
session_idstringyes–
NameTypeReqDescription
bindingobject––
currentobject––
effectstring––
fastboolean|null––
harnessstring––
later_effectstring––
modelstring|null––
observed_atstring––
outcomestring––
providerstring––
reasoning_effortstring|null––
request_statestring––
result–––
schemastringyes–
session_idstring––
terminal_at–––

No examples provided.

agent_goal ~107

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.

NameTypeReqDescription
actionstringyes–
expected_thread_idstring––
launch_idstringyes–
objectivestring––
session_idstringyes–
token_budgetinteger––
NameTypeReqDescription
availabilitystringyes–
binding–yes–
capabilitiesobjectyes–
field_capabilitiesobject––
goal–––
harness–yes–
launch_idstringyes–
mutationstringyes–
native_historyobject––
observed_atstringyes–
outcomestringyes–
readbackstringyes–
reasonstringyes–
schemastringyes–
session_idstringyes–

No examples provided.

agent_launch ~1,292

エージェントを単一の標準入口から永続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を注入し、必要な追加委譲は許可する。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)。

NameTypeReqDescription
cwdstring|null–作業ディレクトリ(絶対パス・任意)
env_varsarray–現在のMCP processから継承する環境変数名
fastboolean|null–ファスト(harnessの高速の応答。費用や利用量が増える)。省略とfalseは通常の速度で起こす(利用者の設定にfastが残っていても通常)。trueは通常で起こしてから、その席をfastへ切り替える。modelがfastに対応していない時(FAST_MODE_NOT_SUPPORTED)と、modelへfast版のIDを書いてfalseを渡した時(FAST_MODE_MODEL_CONFLI…
harnessstringyesagent loop・session・hook・transcript・認証を所有する実行基盤
imagearray–初手プロンプトへ添付する画像ファイルの絶対パス(png/jpg/jpeg/gif/webp)
launch_operation_idstring–Claude Codeのpromptなしexact replay相関だけで使用
modelstring|null–harnessが選ぶモデル。provider名ではなくlive catalog上のmodel ID
promptstring|null–起動時に渡す初手プロンプト(任意)。送信後は待たずに即返る
reasoning_effortstring|null–harness adapterが標準CLI表現へ変換する思考レベル。Cursorではmodel同時指定が必要
remoteobject–別端末のAitermで実行する時のSSH接続情報。hostだけならssh_configの接続名として使う。Aitermは接続情報を保存・管理しない。passphraseは会話記録に残るため、ssh-agentかpassphrase_env(環境変数名)を推奨する。
session_namestring|null–Aiterm session名(省略で自動採番)
throughline_source_sessionstring–同一端末のThroughline sessionから読み取り専用contextを初手へ注入する
throughline_supplement_filestring–Throughline 0.10.8以降へそのまま渡すproject束縛済み長期記憶・知識の補足JSON path
trust_projectboolean–対象projectを信頼し、既知のworkspace・project hooks・MCP初期同意を起動中に進める
write_scopestring–能力宣言。read-onlyは対応harnessの標準read-only面で実効禁止する
NameTypeReqDescription
event_cursor–yes–
fastboolean–起こした後の、席のfastの状態(この項目を返さない版の別端末では無い)
fast_error––fastを頼まれたが、通常の速度で起こした時の訳
harnessstringyes–
initial_promptobjectyes–
input_idstring––
managed_completionbooleanyes–
parent_deliveryobject––
providerstringyes旧互換field。新規連携はharnessを使う
remote_hoststring–別端末で起動した時の接続先
remote_versionstring|null–別端末のAiterm版
schemastringyes–
session_idstringyes–
startupobjectyes–
submit_residueboolean|nullyes–
wait_commandstring|nullyes–
wait_process–yes–
write_scopestring––
write_scope_enforcementstring––

No examples provided.

agent_models ~412

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の候補を返す。

NameTypeReqDescription
cwdstring|null–CLIを実行する作業ディレクトリ(絶対パス・任意)。project設定で候補が変わるharness向け
harnessstringyes候補を取得するharness
include_hiddenboolean–Codexが一覧で隠すmodelも返す(既定false)。他のharnessには隠すmodelが無い
remoteobject–別端末のAitermで実行する時のSSH接続情報。hostだけならssh_configの接続名として使う。Aitermは接続情報を保存・管理しない。passphraseは会話記録に残るため、ssh-agentかpassphrase_env(環境変数名)を推奨する。
NameTypeReqDescription
adapter_effortsobjectyesharnessの一覧には無く、Aitermのadapterが足したeffortと理由
default_modelstring|nullyesmodel省略時にharnessが使うmodel。一覧のIDで表せなければnull
effortsarrayyes全modelのeffortの和
fast_unavailable––このアカウント・この端末では、どのmodelでもfastを使えない時の訳(harnessが先に答えられる時だけ。今はClaude Code)。使える・分からない時はnull
harnessstringyes–
harness_versionstring|nullyes–
modelsarrayyes–
schemastringyes–
sourcestringyes取得に使ったharnessの公式の入口

No examples provided.

claude_agent ~1,102

【旧互換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を注入し、必要な追加委譲は許可する。通常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 でも回収できる。

NameTypeReqDescription
cwdstring|null–作業ディレクトリ(対象リポのルート等・任意)
env_varsarray–起動したagentへ現在のMCP processから継承する環境変数名。値はtool引数へ渡さない
fastboolean|null–ファスト(harnessの高速の応答。費用や利用量が増える)。省略とfalseは通常の速度で起こす(利用者の設定にfastが残っていても通常)。trueは通常で起こしてから、その席をfastへ切り替える。modelがfastに対応していない時(FAST_MODE_NOT_SUPPORTED)と、modelへfast版のIDを書いてfalseを渡した時(FAST_MODE_MODEL_CONFLI…
launch_operation_idstring–promptなしClaude launchのexact replay相関ID。session_name必須
modelstring|null–起動モデル(例: claude-sonnet-4-6)。省略時はClaude CLI既定
promptstring|null–起動時に渡す初手プロンプト(任意)。送信後は待たずに即返る
reasoning_effortstring|null–Claude Code reasoning effort。low/medium/high/xhigh/max。省略時はCLI既定
session_namestring|null–セッション名(省略で自動採番)
throughline_source_sessionstring–同一端末のThroughline sessionから所有権を変えずに記憶を読み、promptのmissionより前へ注入する
throughline_supplement_filestring–Throughline 0.10.8以降へそのまま渡すproject束縛済み長期記憶・知識の補足JSON path
trust_projectboolean–対象projectを信頼し、既知のworkspace・project hooks・MCP初期同意を起動中に進める
NameTypeReqDescription
event_cursor–yes–
fastboolean–起こした後の、席のfastの状態
fast_error––fastを頼まれたが、通常の速度で起こした時の訳
harnessstringyes–
initial_promptobjectyes–
input_idstring––
managed_completionbooleanyes後方互換field。trueはaiterm完了相関が有効という意味で、project/user環境の隔離を意味しない
parent_deliveryobject––
providerstringyes–
schemastringyes–
session_idstringyes–
startupobjectyes–
submit_residueboolean|nullyes–
wait_commandstring|nullyes–
wait_process–yes–

No examples provided.

claude_approval ~244

aiterm相関付きClaudeのactive turn中に表示された権限確認UIを、turn相関を保ったまま検査・応答する専用面。inspectで画面digestと安全な単発Yes/Noだけを取得し、respondは同じoperation・同じdigestが現在も表示中の場合だけ送信する。

NameTypeReqDescription
actionstringyes–
approval_choicestring–respondだけに指定する
observed_prompt_digeststring–直前のinspectが返したdigest。respondだけに指定する
operation_id––durable operationのID。通常pty_send由来の匿名turnでは省略する
remoteobject–別端末のAitermで実行する時のSSH接続情報。hostだけならssh_configの接続名として使う。Aitermは接続情報を保存・管理しない。passphraseは会話記録に残るため、ssh-agentかpassphrase_env(環境変数名)を推奨する。
session_idstringyes–
NameTypeReqDescription
actionstringyes–
atstringyes–
choicesarrayyes–
operation_id–yes–
prompt_digeststringyes–
schemastringyes–
selected_choice–yes–
session_idstringyes–
statusstringyes–

No examples provided.

claude_turn ~187

aiterm相関付きClaude sessionのdurable operationを構造化issue/recoverするmachine-caller専用面。pending/unknown/completedを人間向けerror文字列の解析なしで返し、Observer固有ロジックは持たない。

NameTypeReqDescription
actionstringyes–
operation_idstringyes–
remoteobject–別端末のAitermで実行する時のSSH接続情報。hostだけならssh_configの接続名として使う。Aitermは接続情報を保存・管理しない。passphraseは会話記録に残るため、ssh-agentかpassphrase_env(環境変数名)を推奨する。
session_idstringyes–
textstring–issueだけに指定するbounded turn本文
NameTypeReqDescription
actionstringyes–
operation_idstringyes–
parent_deliveryobject––
raw_outputstring|nullyes–
reason–yes–
schemastringyes–
session_idstringyes–
statusstringyes–
submit_residueboolean|nullyes–

No examples provided.

codex_agent ~1,286

【旧互換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を注入し、必要な追加委譲は許可する。委譲契約を使う完全な呼び出し例: `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 既定を継承。実効値は起動応答に明示)。

NameTypeReqDescription
cwdstring|null–作業ディレクトリ(対象リポのルート等・任意)
env_varsarray–起動したagentへ現在のMCP processから継承する環境変数名。値はtool引数へ渡さない
fastboolean|null–ファスト(harnessの高速の応答。費用や利用量が増える)。省略とfalseは通常の速度で起こす(利用者の設定にfastが残っていても通常)。trueは通常で起こしてから、その席をfastへ切り替える。modelがfastに対応していない時(FAST_MODE_NOT_SUPPORTED)と、modelへfast版のIDを書いてfalseを渡した時(FAST_MODE_MODEL_CONFLI…
modelstring|null–起動モデル(例: gpt-5.6-sol / gpt-5.6-terra / gpt-5.6-luna)。省略時は端末 config/CLI 既定を継承(端末側のピンがそのまま効く。実効値は起動応答に明示される)
promptstring|null–起動時に渡す初手プロンプト(任意)。送信後は待たずに即返る
reasoning_effortstring|null–reasoning effort(思考レベル)。low/medium/high/xhigh/max/ultra(CLI/model 版依存)。ultra は max 推論+proactive 自動委譲 ON=使用量急増注意(明示要求時のみ)。省略時は端末 config/CLI 既定。
session_namestring|null–セッション名(省略で自動採番)
throughline_source_sessionstring–同一端末のThroughline sessionから所有権を変えずに記憶を読み、promptのmissionより前へ注入する
throughline_supplement_filestring–Throughline 0.10.8以降へそのまま渡すproject束縛済み長期記憶・知識の補足JSON path
trust_projectboolean–対象projectを信頼し、既知のworkspace・project hooks・MCP初期同意を起動中に進める
write_scopestring–能力宣言。read-only、または書込みを許可するパスの説明文字列。対応harnessのread-onlyはCLI標準のread-only面で実効禁止する
NameTypeReqDescription
event_cursor–yes–
fastboolean–起こした後の、席のfastの状態
fast_error––fastを頼まれたが、通常の速度で起こした時の訳
harnessstringyes–
initial_promptobjectyes–
input_idstring––
managed_completionbooleanyes後方互換field。trueはaiterm完了相関が有効という意味で、project/user環境の隔離を意味しない
parent_deliveryobject––
providerstringyes–
schemastringyes–
session_idstringyes–
startupobjectyes–
submit_residueboolean|nullyes–
wait_commandstring|nullyes–
wait_process–yes–
write_scopestring––
write_scope_enforcementstring––

No examples provided.

diagnostics ~137

Factory 向け read-only 診断。安全な状態語彙だけを機械可読 JSON で返す(PTY 内容・認証情報・path・環境値は返さない)。2つ目のtextは親配送hook(Claude Code・Cursor)の登録状態で、caller_status が setup_required なら呼出元からのagent送信は拒否される。aiterm-setup を実行する。

NameTypeReqDescription
formatstring–既定v1は既存の固定fieldを維持。v2はPTY診断の安全なreason_codeを含む。

No output schema declared.

No examples provided.

grok_agent ~1,129

【旧互換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を注入し、必要な追加委譲は許可する。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に対応。

NameTypeReqDescription
cwdstring|null–作業ディレクトリ(対象リポのルート等・任意)
env_varsarray–起動したagentへ現在のMCP processから継承する環境変数名。値はtool引数へ渡さない
fastboolean|null–ファスト(harnessの高速の応答。費用や利用量が増える)。省略とfalseは通常の速度で起こす(利用者の設定にfastが残っていても通常)。trueは通常で起こしてから、その席をfastへ切り替える。modelがfastに対応していない時(FAST_MODE_NOT_SUPPORTED)と、modelへfast版のIDを書いてfalseを渡した時(FAST_MODE_MODEL_CONFLI…
modelstring|null–起動モデル。省略時は grok-4.6。explicit modelを起動前にlive catalogへ照合し、不在ならfallbackせずエラー
promptstring|null–起動時に渡す初手プロンプト(任意)。送信後は待たずに即返る
reasoning_effortstring|null–Grok Build reasoning effort。利用可能値はCLI/modelのlive catalogに従う。省略時はCLI/model既定。
session_namestring|null–セッション名(省略で自動採番)
throughline_source_sessionstring–同一端末のThroughline sessionから所有権を変えずに記憶を読み、promptのmissionより前へ注入する
throughline_supplement_filestring–Throughline 0.10.8以降へそのまま渡すproject束縛済み長期記憶・知識の補足JSON path
trust_projectboolean–対象projectを信頼し、既知のworkspace・project hooks・MCP初期同意を起動中に進める
write_scopestring–能力宣言。read-only、または書込みを許可するパスの説明文字列。対応harnessのread-onlyはCLI標準のread-only面で実効禁止する
NameTypeReqDescription
event_cursor–yes–
fastboolean–起こした後の、席のfastの状態
fast_error––fastを頼まれたが、通常の速度で起こした時の訳
harnessstringyes–
initial_promptobjectyes–
input_idstring––
managed_completionbooleanyes後方互換field。trueはaiterm完了相関が有効という意味で、project/user環境の隔離を意味しない
parent_deliveryobject––
providerstringyes–
schemastringyes–
session_idstringyes–
startupobjectyes–
submit_residueboolean|nullyes–
wait_commandstring|nullyes–
wait_process–yes–
write_scopestring––
write_scope_enforcementstring––

No examples provided.

pty_close ~139

セッションを閉じ、ログ/読取位置を破棄する。同じsession_idへの再試行は安全で、closed/already_closedのstructured receiptを返す。

NameTypeReqDescription
remoteobject–別端末のAitermで実行する時のSSH接続情報。hostだけならssh_configの接続名として使う。Aitermは接続情報を保存・管理しない。passphraseは会話記録に残るため、ssh-agentかpassphrase_env(環境変数名)を推奨する。
session_idstringyes–
NameTypeReqDescription
outcomestringyes–
schemastringyes–
session_idstringyes–

No examples provided.

pty_key ~196

制御キーを送る(C-c, C-d, Enter, Tab, Up, Down... の別名に対応)。acceptedは入力受付であり処理中断/会話維持の確認ではない。aiterm相関付きClaudeではC-cだけを許可し、承認UIはclaude_approvalで操作する。

NameTypeReqDescription
keystringyesキー名(例 "C-c", "Enter", "Up")
remoteobject–別端末のAitermで実行する時のSSH接続情報。hostだけならssh_configの接続名として使う。Aitermは接続情報を保存・管理しない。passphraseは会話記録に残るため、ssh-agentかpassphrase_env(環境変数名)を推奨する。
session_idstringyes–

No output schema declared.

No examples provided.

pty_list ~151

握っているセッション一覧(名前 / 現在の前面コマンド / attach 状態 / サイズ / agent 情報)。

NameTypeReqDescription
env_keysarray–帰属確認用の非秘密環境変数名。指定したキーだけを返す
remoteobject–別端末のAitermで実行する時のSSH接続情報。hostだけならssh_configの接続名として使う。Aitermは接続情報を保存・管理しない。passphraseは会話記録に残るため、ssh-agentかpassphrase_env(環境変数名)を推奨する。
NameTypeReqDescription
observed_atstringyes–
schemastringyes–
sessionsarrayyes–

No examples provided.

pty_observe ~180

指定sessionの存在、paneとharnessの生存、状態と理由、native process identity、画面変化とCPU活動を構造化して観測する。画面本文と生argvは返さない。

NameTypeReqDescription
cursorstring–前回のactivity.cursor。省略・session再作成時は活動差分をnullで返す
remoteobject–別端末のAitermで実行する時のSSH接続情報。hostだけならssh_configの接続名として使う。Aitermは接続情報を保存・管理しない。passphraseは会話記録に残るため、ssh-agentかpassphrase_env(環境変数名)を推奨する。
session_idstringyes–
NameTypeReqDescription
activityobjectyes–
existsbooleanyes–
harness–yes–
harness_aliveboolean|nullyes–
harness_process–yes–
launch_idstring|nullyes–
observed_atstringyes–
pane_aliveboolean|nullyes–
pane_process–yes–
parent_deliveriesarray––
pending_child_deliveriesnumber|null––
process_identity–yes–
reasonstringyes–
schemastringyes–
session_idstringyes–
statestringyes–
token_hintnumber|nullyes–

No examples provided.

pty_open ~301

ローカル永続端末(POSIXはtmux、Windows nativeはpsmux 3.3.8以上)を1個開き、session_id を返す。backend server常駐ゆえ本サーバや クライアントが再起動してもセッションは生存する。リモート操作は専用ツールにせず、開いた端末の中で pty_send(session_id, "ssh host") と打って入る。

NameTypeReqDescription
env_varsarray–sessionへ登録する環境変数名(値は現在のMCP processから読む。pty_listのenv_keysで読める)。端末の環境は、名指ししなくても現在のMCP processの環境を継ぐ
namestring|null–セッション名(省略時は t1, t2... を自動採番)
remoteobject–別端末のAitermで実行する時のSSH接続情報。hostだけならssh_configの接続名として使う。Aitermは接続情報を保存・管理しない。passphraseは会話記録に残るため、ssh-agentかpassphrase_env(環境変数名)を推奨する。
shellstring–起動シェル(既定 bash)

No output schema declared.

No examples provided.

pty_read ~593

セッションの出力をトークン削減して読む(既定は前回読取位置からの増分)。削減: 制御文字除去 / 反復圧縮 / head+tail 折りたたみ+復元ヒント+メタ併記。agent_transcript:true は agent session の直近完了ターンの最終 assistant メッセージを公開されたharness記録から平文で返す。回答が空で終わったターンは誤りにせず、空のtextとanswer_empty:trueを返す。長い回答が screen tail で切れた時の回収用。

NameTypeReqDescription
agent_transcriptboolean–agent session の直近完了ターンの最終 assistant メッセージを返す。Claudeはlaunch相関付きStop hook result、他harnessは通常transcript/session historyを使う。長い回答がscreen tailで切れた時の回収用
fullboolean–増分でなく全文
line_rangestring|null–全文からの行範囲 "A:B"
lines––末尾 N 行のみ
operation_id––Claude operationの期待ID。agent_transcript:true時だけ指定し、古い別operationの結果を拒否する
rawboolean–削減せず生テキスト
remoteobject–別端末のAitermで実行する時のSSH接続情報。hostだけならssh_configの接続名として使う。Aitermは接続情報を保存・管理しない。passphraseは会話記録に残るため、ssh-agentかpassphrase_env(環境変数名)を推奨する。
rtkboolean–直前コマンド別の自前 reducer(git/grep/pytest 等)で縮約
screenboolean–描画済みスクリーン(TUI 向け)
session_idstringyes–
timeoutnumber–wait の最大待ち秒数
untilstring|null–この文字列が出たら完了とみなす(既定はリテラル部分一致。`$ ` や `[..]` もそのまま探せる)
until_regexboolean–until を正規表現として扱う(既定 false=リテラル部分一致。メタ文字を使いたい時のみ true)
waitboolean–完了まで待つ(dead / mark sentinel 自動検出 / until / 出力静止∧シェル復帰 / timeout)
NameTypeReqDescription
answer_emptyboolean|null–agent_transcriptで、完了したturnの回答が空だった時だけtrue(textは空文字列)。回答を読めなかった時は誤りを返す。terminalではnull
harness–yes–
modestringyes–
raw_chars–yes–
schemastringyes–
session_idstringyes–
textstringyes–
turn_idstring|nullyes–
vendor–yes–

No examples provided.

pty_send ~1,302

セッションへテキストを送る。通常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を使う。

NameTypeReqDescription
enterboolean–末尾で Enter を送る(agent dispatch では常に submit)
forceboolean–非Claude agent sessionでは自動dispatchせず素送信する。aiterm相関付きClaudeのactive turnには使えない
imagearray–添付する画像ファイルの絶対パス(png/jpg/jpeg/gif/webp)。agent session への dispatch だけで使え、harness別の添付手順はaitermが吸収する。通常PTY送信やforce送信では指定できない
markboolean–完了 sentinel(終了コード付き)で包む。pty_read(wait:true) が until 無しでも自動検出して完了確定する(POSIX shell と PowerShell に対応。SSH先の現在の標準PS promptも自動判定。PowerShell の rc は成功0/失敗1。fish/csh/tcsh は未対応として送信前に拒否)。 enter:false と併用すると se…
prefacestring–agent session への送信(forceなし)で、本文の前に置く1行。送る文は「preface・空行・text」の並びになる。Claude Codeの席ではprefaceを貼り付けの印なしで入れ、textだけを貼る。Codex/Grok/Cursor/Antigravityの席では1つで貼る。1行・200字以内・制御文字なしで、行頭が記号や空白でなく、@ を含まない文。外れた時と通常PT…
rawboolean–送信前サニタイズを無効化
remoteobject–別端末のAitermで実行する時のSSH接続情報。hostだけならssh_configの接続名として使う。Aitermは接続情報を保存・管理しない。passphraseは会話記録に残るため、ssh-agentかpassphrase_env(環境変数名)を推奨する。
require_agentboolean–agent登録が無いsessionは打鍵前に拒否する。force:trueとは併用できない
rtkboolean–既知コマンドを rtk 形へ委譲して送る(rtk 不在なら素通し)
session_idstringyes–
textstringyes送る文字列(コマンド/prompt)。UTF-8で最大64KiB
NameTypeReqDescription
event_cursor–yes–
harness–yes–
input_idstring––
launch_idstring|nullyes–
modestringyes–
pane_input_recoveryarray––
parent_deliveryobject––
schemastringyes–
session_idstringyes–
submit_residueboolean|nullyes–
vendor–yes–
wait_process–yes–

No examples provided.

Install

How do I install the io.github.kitepon/aiterm-mcp server?

io.github.kitepon/aiterm-mcp runs locally as an npm package, launched with npx -y aiterm-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

npm · aiterm-mcp

# add to Claude Code
claude mcp add kitepon-aiterm-mcp -- npx -y aiterm-mcp
Common questions

What is the io.github.kitepon/aiterm-mcp server?

io.github.kitepon/aiterm-mcp is listed in the public MCP registry as io.github.kitepon/aiterm-mcp. Persistent terminals and one launcher for Claude, Codex, Grok, Cursor, and Antigravity harnesses. This page covers its npm package (aiterm-mcp).

Is the io.github.kitepon/aiterm-mcp server safe to use?

io.github.kitepon/aiterm-mcp scores 88 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 5 November 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the io.github.kitepon/aiterm-mcp server expose?

io.github.kitepon/aiterm-mcp exposes 19 tools: diagnostics, pty_open, pty_send, pty_read, pty_key, and 14 more. Their descriptions and schemas cost roughly 10,065 tokens of context every time the server is loaded.

Is the io.github.kitepon/aiterm-mcp server still maintained?

io.github.kitepon/aiterm-mcp is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the io.github.kitepon/aiterm-mcp server under?

io.github.kitepon/aiterm-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.