Aiterm MCP

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

Connector by kitepon · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 6

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/kitepon-aiterm-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

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

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools: 1 read · 3 write · 0 delete · 17 not yet classified
Secrets: None asked for
Install scripts: None found
Runs as: Node.js package

Tools by what they do 21

Read from the source code; the running server may list different tools.

Read 1 · Look things up without changing anything.

pty_read

Write 3 · Create, change, send or run things.

agent_stop
pty_close
pty_send

Not yet classified 17 · We could not tell from the name and description.

agent_approval
agent_auth
agent_configure
agent_execution
agent_execution_roots
agent_launch
agent_models
claude_agent
claude_approval
claude_turn
codex_agent
diagnostics

Show 5 more tools

grok_agent
pty_key
pty_list
pty_observe
pty_open

Show 15 more hosts

man7.org · found in code
mariozechner.at · found in code
mcp.so · found in code
news.ycombinator.com · found in code
packetlabs.net · found in code
per.bothner.com · found in code
prod.cursor.com · found in code
raw.githubusercontent.com · found in code
roocodeinc.github.io · found in code
smithery.ai · found in code
support.claude.com · found in code
tbench.ai · found in code
tcl-lang.org · found in code
tsapps.nist.gov · found in code
vt100.net · found in code

Files it touches

/dev
/dev/null
/etc/os-release
/opt/homebrew/bin/brew
/opt/homebrew/bin/tmux
/proc/stat
/usr/libexec/PlistBuddy
Your home directory (~)
~/.grok/bin/grok
~/.local/bin/claude
~/.local/bin/codex
~/.local/bin/cursor-agent
C:\\Windows

Tools (21)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

agent_approval
Codexの現在の承認をinspectし、digestへ束縛した単発許可または拒否をrespondする。恒久許可は選ばない。Claudeは既存claude_approvalを使う。未知dialogはblockedのtyped errorで返す。
agent_auth
各harnessの公式CLI認証を開始・確認・取消する。CLIごとのコマンドと認証URL/codeの抽出はAitermが所有し、資格情報は各CLIだけが保存する。waitingのURL/codeを人へ表示し、input_requiredなら同じsessionのpty_send／pty_keyで公式画面へ入力する。authenticatedは認証の結果であり、agent_launchの起動準備完了とは別。remoteは他toolと同じ標準対応。startは公式の状態が認証済みなら何も起こさずauthenticatedを返す。relogin:trueを付けると、認証済みに見えても公式ログインを開始する（別のアカウントへ入り直す時、ログインの期限切れを状態から見抜けない時）。Aitermは資格情報を消さず、置き換えは公式CLIが行う。Codexの公式ログインは、始めた時点で元のログインを消す（途中でcancelしても戻らない）。
agent_configure
起動済みのClaude／Codex／Grok／Cursor 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を書…
agent_execution
既存の実配送/実行参照を登録・照会・終了証拠で更新する。結果不明の空起動は元requestと期待世代を指定して照合、または終了済みCLIだけcloseする。本文や再送queueは保存しない。
agent_execution_roots
指定席の現在launchと保存済み未完了branchの実世代/期待世代を読む。過去完了履歴は返さず、停止や登録は行わない。
agent_launch
Description is built at runtime.
agent_models
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へ分けたもの。返るidとeffortsはagent_launch／agent_configureへそのまま渡せる。modelごとのfastは、そのmodelでfastへ切り替えられるか（harnessが返す値）。fast_unavailableは、アカウントの都合でどのmodelでも使えない時の訳。取得不能はMODEL_CATALOG_UNAVAILABLE、形式異常はMODEL_CATALOG_INVALIDのエラーで返し、別の一覧へfallbackしない。remoteを付けると別端末のharnessの候補を返す。
agent_stop
指定sessionとその呼出先へ末端から通常の停止キーを送る。sentはキー送信結果であり終了の証明ではない。
claude_agent
Description is built at runtime.
claude_approval
aiterm相関付きClaudeのactive turn中に表示された権限確認UIを、turn相関を保ったまま検査・応答する専用面。inspectで画面digestと安全な単発Yes/Noだけを取得し、respondは同じoperation・同じdigestが現在も表示中の場合だけ送信する。
claude_turn
aiterm相関付きClaude sessionのdurable operationを構造化issue／recoverするmachine-caller専用面。pending／unknown／completedを人間向けerror文字列の解析なしで返し、Observer固有ロジックは持たない。
codex_agent
Description is built at runtime.
diagnostics
Factory 向け read-only 診断。安全な状態語彙だけを機械可読 JSON で返す（PTY 内容・認証情報・path・環境値は返さない）。2つ目のtextは親配送hook（Claude Code・Cursor）の登録状態で、caller_status が setup_required なら呼出元からのagent送信は拒否される。aiterm-setup を実行する。
grok_agent
Description is built at runtime.
pty_close
セッションを閉じ、ログ／読取位置を破棄する。同じsession_idへの再試行は安全で、closed／already_closedのstructured receiptを返す。

Show 6 more tools

pty_key
制御キーを送る（C-c, C-d, Enter, Tab, Up, Down... の別名に対応）。acceptedは入力受付であり処理中断/会話維持の確認ではない。aiterm相関付きClaudeではC-cだけを許可し、承認UIはclaude_approvalで操作する。
pty_list
握っているセッション一覧（名前 / 現在の前面コマンド / attach 状態 / サイズ / agent 情報）。
pty_observe
指定sessionの存在、paneとharnessの生存、状態と理由、native process identity、画面変化とCPU活動を構造化して観測する。画面本文と生argvは返さない。
pty_open
ローカル永続端末（POSIXはtmux、Windows nativeはpsmux 3.3.8以上）を1個開き、session_id を返す。backend server常駐ゆえ本サーバやクライアントが再起動してもセッションは生存する。リモート操作は専用ツールにせず、開いた端末の中で pty_send(session_id, "ssh host") と打って入る。
pty_read
セッションの出力をトークン削減して読む（既定は前回読取位置からの増分）。削減: 制御文字除去 / 反復圧縮 / head+tail 折りたたみ＋復元ヒント＋メタ併記。agent_transcript:true は agent session の直近完了ターンの最終 assistant メッセージを公開されたharness記録から平文で返す。回答が空で終わったターンは誤りにせず、空のtextとanswer_empty:trueを返す。長い回答が screen tail で切れた時の回収用。
pty_send
セッションへテキスト(コマンド)を送る。送信後の出力は pty_read で取得する。 Args: session_id: 対象セッション。 text: 送る文字列（コマンド）。 enter: 末尾で Enter を送る（既定 True）。 mark: 完了 sentinel（終了コード付き）で包む。 force: 破壊的コマンドゲートを越える（既定は遮断）。 rtk: 既知コマンドを rtk 形へ委譲して送り、実行先で出力削減を効かせる（rtk 不在なら素通し）。 raw: 送信前サニタイズを無効化（既定はサニタイズ有効）。

Signals

Stars: 6
Forks: 0
Open issues: 0
Last commit: Oct 24, 2026 (5 days ago)
Last release: Oct 26, 2026 (3 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name: io.github.kitepon/aiterm-mcp
Version: 0.61.21
Auth: No auth
Packages: npm aiterm-mcp
License: MIT
Repository: github.com/kitepon/aiterm-mcp
First seen: Oct 24, 2026
Last checked: Oct 26, 2026
Source: Official MCP Registry github-graphql

Cite this page

Aiterm MCP. Agent Mart. https://agentmart.dev/connectors/kitepon-aiterm-mcp (last updated 2026-10-26)