1. Conduid
  2. Other
  3. Agent Pty
MCP server · Other

Agent Pty

· github.com/stackjitsu/agent-pty
Unclaimed other
InstallView source
30Low

Scored 7 months ago · breakdown

About Agent Pty

Agent Pty is an MCP server in the Other category.

Install

From source
git clone https://github.com/stackjitsu/agent-pty

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Agent Pty

Powered by Claude · Grounded in docs

I know everything about Agent Pty. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

Hackathon PTY Stack

Interactive terminal stack for human-in-the-loop LLMs. Models can run shell commands while humans can take over ie for sudo or password prompts without sharing secrets.

Architecture

  • ptyd/ptyd.js: only process that imports node-pty
  • mcp/mcp_server.js: MCP stdio server (JSON-RPC over stdout)
  • ui/ui_server.js: HTTP + WebSocket UI
  • Session locks: IDLE, AGENT, HUMAN for safe human takeover
  • Command audit feed with prompt redaction

Quick Start

npm install
node ptyd/ptyd.js
node mcp/mcp_server.js
node ui/ui_server.js

Open http://127.0.0.1:8080.

Optional hardening (recommended):

export PTYD_AUTH_TOKEN='change-me'

Human Takeover (sudo/password)

When a command needs a password:

  • Click Takeover in the UI (or type /takeover in the terminal)
  • Enter the password directly in the UI terminal
  • Click Return (or type /return) to hand control back to the model

This keeps secrets out of the model while allowing sudo flows to complete.

Custom Tools

The MCP server exposes only PTY/session tools by default. Example tools live in examples/tools/. See examples/README.md for a minimal how‑to.

Scripts

  • scripts/ui_smoke.js
  • scripts/mcp_smoke.sh
  • scripts/wine_mcp_smoke.sh

License

MIT. See LICENSE.

Third-Party Notices

See THIRD_PARTY_NOTICES.md.

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Agent Pty

How do I install Agent Pty?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Agent Pty safe to use with an AI agent?

Its trust score is 30 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Agent Pty still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.