{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_c4nudhehujac","handle":"vterm-rs-python-mcp","url":"https://wellknown.network/agents/vterm-rs-python-mcp","links":{"self":"https://wellknown.network/agents/vterm-rs-python-mcp/record.json","html":"https://wellknown.network/agents/vterm-rs-python-mcp","markdown":"https://wellknown.network/agents/vterm-rs-python-mcp/record.md","api":"https://wellknown.network/api/v1/agents/vterm-rs-python-mcp","status":"https://wellknown.network/api/v1/agents/vterm-rs-python-mcp/status","claim":"https://wellknown.network/agents/vterm-rs-python-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/vterm-rs-python-mcp/claim.json","badge":"https://wellknown.network/agents/vterm-rs-python-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:vterm-rs-python-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"vterm-rs-python-mcp","summary":"High-performance Python SDK for the vterm-rs PTY orchestrator","description":"# vterm-rs\n\n[![Crates.io](https://img.shields.io/crates/v/vterm-rs.svg)](https://crates.io/crates/vterm-rs)\n[![PyPI](https://img.shields.io/pypi/v/vterm-rs-python-mcp.svg)](https://pypi.org/project/vterm-rs-python-mcp/)\n[![CI](https://github.com/margusmartsepp/vterm-rs/actions/workflows/rust-ci.yml/badge.svg)](https://github.com/margusmartsepp/vterm-rs/actions)\n[<img src=\"https://cursor.com/deeplink/mcp-install-dark.svg\" alt=\"Install in Cursor\" height=\"20\">](https://cursor.com/en/install-mcp?name=vterm-rs&config=eyJjb21tYW5kIjoidXZ4IiwiaW5zdGFsbCI6InZ0ZXJtLXJzLXB5dGhvbi1tY3AiLCJhcmdzIjpbInZ0ZXJtLXJzLXB5dGhvbi1tY3AiXX0%3D)\n\n> **The High-Performance Rust PTY Orchestrator for AI Agents.**\n\n`vterm-rs` is a state-aware terminal host built specifically for AI agents (and the humans who build them). It transforms the terminal from a \"blind black box\" into a **State Machine** that agents can inspect, reason about, and control fluently.\n\n## Why vterm-rs?\n\n*   **Safety (Guardrails)**: Prevent \"Infinite Log Floods\" with `max_lines` and `max_duration` limits.\n*   **Truth (State Machine)**: Don't guess if a command finished. Use `wait_until` and `screen_read` to inspect the visual grid.\n*   **Fluent Fleet**: Orchestrate multiple terminals atomically with the high-performance `batch()` API.\n*   **Headless-First**: Designed for CI/CD and AI backends, with optional `--visible` mode for debugging.\n\n## Quick Start (Python SDK)\n\n```python\nimport vterm_python\n\nclient = vterm_python.VTermClient()\n\n# The \"Fluent Fleet\" way: Atomically set up your session\nops = [\n    client.spawn_op(\"Build\", visible=True),\n    client.write_op(1, \"cargo build<Enter>\"),\n    client.wait_until_op(1, \"Finished\", timeout_ms=30000)\n]\n\nresult = client.batch(ops)\nprint(f\"Build status: {result['sub_results'][2]['status']}\")\n```\n\n```mermaid\ngraph LR\n    Agent[\"AI agent<br/>(Claude/IDE/MCP)\"]\n    Term[\"vterm.exe<br/>(PTY pool, vt100, reaper)\"]\n    Shell[\"powershell.exe<br/>(your real shell)\"]\n\n    Agent -- \"NDJSON o…","publisher":null,"homepage":null,"repository":null,"version":"0.7.22","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:vterm-rs-python-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.ci-cd","name":"CI/CD & Deploy","confidence":1,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.791,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"vterm-rs-python-mcp","registry":"pypi","observedAt":"2026-09-10T15:25:18.857Z","publishedAt":"2026-04-29T09:14:07.267352Z","latestVersion":"0.7.22"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"vterm-rs-python-mcp","url":"https://pypi.org/project/vterm-rs-python-mcp/","firstSeenAt":"2026-09-10T15:23:58.439Z","fetchedAt":"2026-09-10T15:23:58.439Z","normalizedAt":"2026-09-10T15:23:58.439Z"}]},"firstSeenAt":"2026-09-10T15:23:58.439Z","updatedAt":"2026-09-10T15:25:18.857Z"}