Bytars

CLI Agent MCP — Development skill for Claude Code

Development community

MCP (stdio) server that lets Claude Desktop drive a local headless CLI coding agent (Claude Code or Cursor) as a streaming background worker — with live progress notifications and inherited VPN/SSH ac.

How to install CLI Agent MCP

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Bytars/cli-agent-mcp and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What CLI Agent MCP does

MCP (stdio) server that lets Claude Desktop drive a local headless CLI coding agent (Claude Code or Cursor) as a streaming background worker — with live progress notifications and inherited VPN/SSH access to internal servers.

Alternatives in Development

  • Peon Ping — Warcraft III Peon voice notifications (+ StarCraft, Portal, Zelda) for Claude Code and other agents 4k ★
  • Call Me — Minimal plugin that lets Claude Code call you on the phone 2.5k ★
  • MCP Proxy — A bridge between Streamable HTTP and stdio MCP transports 2.4k ★

README

cli-agent-mcp

[![ci](https://github.com/Bytars/cli-agent-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Bytars/cli-agent-mcp/actions/workflows/ci.yml) [![release](https://github.com/Bytars/cli-agent-mcp/actions/workflows/release.yml/badge.svg)](https://github.com/Bytars/cli-agent-mcp/actions/workflows/release.yml) [![latest release](https://img.shields.io/github/v/release/Bytars/cli-agent-mcp?sort=semver)](https://github.com/Bytars/cli-agent-mcp/releases/latest) [![Go Reference](https://pkg.go.dev/badge/github.com/Bytars/cli-agent-mcp.svg)](https://pkg.go.dev/github.com/Bytars/cli-agent-mcp) [![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](./LICENSE)

A single-binary **MCP (Model Context Protocol) stdio server** that lets an MCP client — such as **Claude Desktop** — drive a **local headless CLI coding agent** as a background worker, with **live progress streaming**.

Out of the box it drives **Claude Code** and **Cursor**, and any other CLI tool can be wired up with environment variables alone — no code required.

Instead of copy-pasting between a chat window and a terminal agent, the client delegates a task, watches the worker narrate its progress in real time, and gets the result inline — as if it had done the work itself.

Why run the agent locally?

The worker is spawned as a **child process of this server and inherits its environment**. That means it can reach whatever the host machine can reach:

  • private networks and VPN routes,
  • internal hosts via your SSH agent (1Password, ssh-agent, Pageant, …),
  • cloud CLIs, kubeconfigs, and any credentials already set up on the box.

The MCP client never sees your keys or tokens — it just delegates a task to a worker that already has access.

MCP client (e.g. Claude Desktop)
        │  MCP over stdio
        ▼
  cli-agent-mcp                      ← this project
        │  spawn (headless)
        ▼
  claude / cursor-agent / your CLI   ← inherits env: VPN, S