alejandroqh

alejandroqh / npcterm

Public

A headless, in-memory terminal emulator for AI agents, exposed via MCP

agentic-ai harness headless pty terminal
22
0
100% credibility
Found Apr 16, 2026 at 22 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Rust
AI Summary

NPCterm is a headless terminal emulator enabling AI agents to spawn shells, execute commands, read screens, and interact with text-based applications via a protocol for AI tools.

How It Works

1
📰 Discover NPCterm

You hear about a handy tool that lets AI assistants control a virtual computer screen to run commands just like a human.

2
🚀 Get it ready

You download a simple file for your computer or install it easily, and it's set up in moments.

3
🤖 Connect to your AI

You link the tool to your favorite AI helper so it can use the virtual screen.

4
🖥️ AI starts a screen

Your AI creates a fresh virtual terminal window, picking the perfect size for the job.

5
⌨️ AI takes control

The AI types commands, reads the output, clicks with a mouse, and navigates programs smoothly.

6
👀 Watch it happen

You open a web page to see the live action, with a log of every move your AI makes.

🎉 AI automates everything

Your AI now handles complex computer tasks perfectly, saving you time while staying safe.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 22 to 22 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is npcterm?

npcterm is a Rust-powered headless, in-memory terminal emulator designed for AI agents, exposed via the MCP protocol. It lets agents spawn shells, type commands, read screens, send mouse events, and navigate TUIs like vim or htop—essentially handing them full computer access without a real display. Install via Cargo, configure as an MCP server in tools like Claude Desktop or OpenClaw, and agents get 17 tools for precise control.

Why is it gaining traction?

Unlike basic shell wrappers, npcterm handles full ANSI emulation, incremental screen reads to save tokens, process state detection, and events like CommandFinished—making agents smarter and less wasteful. The built-in web viewer streams live terminals with activity logs, perfect for debugging agent flows. Multi-terminal support and mouse/scroll tools enable complex interactions, standing out in the headless terminal space for AI harnesses.

Who should use this?

AI agent builders integrating LLMs with shell automation, like devs prompting Claude to run scripts or monitor systems via htop/btop. Teams using OpenClaw or MCP clients for autonomous workflows, especially those needing TUI navigation without brittle parsing. Avoid if you just want simple command execution—it's overkill there.

Verdict

Try npcterm if you're building agentic systems needing deep terminal access; the MCP tools and viewer deliver real power despite low maturity (22 stars, 1.0% credibility). Docs are solid with examples, but sandbox aggressively—it's unrestricted shell access. Promising for Rust fans, but watch for production hardening.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.