localhost app

@getlocalhost/cli

Connects your coding agents to localhost mcp, the MCP server of localhost app, from a terminal:

npx @getlocalhost/cli mcp install

It adds a server named localhost to Claude Code, Claude Desktop, Cursor and Codex, whichever are on this computer, and installs the localhost-mcp skill where each agent reads skills. The server runs the localhost command that comes with the app, so the app must be installed: without it, this prints how to install it for your OS and changes nothing.

It writes what Settings → Agents in the app writes, and the app shows these agents as connected:

• Only its own entries. Every other server and setting in the file stays as it was, comments and order included. A file it can't read is reported and left alone.
• A backup first, in the agent-backups folder of localhost's data folder, before it first changes a file.
• Running it again changes nothing.

Commands

npx @getlocalhost/cli mcp install     # add the server and the skillnpx @getlocalhost/cli mcp uninstall   # remove them, and nothing elsenpx @getlocalhost/cli mcp status      # where each agent standsnpx @getlocalhost/cli mcp serve       # run the server, for an MCP client's configuration

Then start a new Claude Code session, quit and reopen Claude Desktop, check Cursor Settings → MCP, or restart Codex.

Any MCP client

mcp serve is the server itself, for any client that starts MCP servers over stdio:

{  "mcpServers": {    "localhost": { "command": "npx", "args": ["-y", "@getlocalhost/cli", "mcp", "serve"] }  }}

It finds the app's localhost command as mcp install does and runs localhost mcp with the client's stdin and stdout, passing on Ctrl-C and other signals and exiting as the server does. mcp serve --read-only runs localhost mcp --read-only. It writes nothing to stdout itself, since that is the client's channel: without the app, or with an app whose command doesn't run, it says why on stderr and exits with 1. claude mcp add --scope user localhost -- npx -y @getlocalhost/cli mcp serve and codex mcp add localhost -- npx -y @getlocalhost/cli mcp serve add it from a terminal.

More in the MCP docs. Node 18 or later; no dependencies.

Development

cd packages/clinpm testnode bin/getlocalhost.js mcp status

The JSON and TOML editors are the same as the core's (core/localhost-core/src/agents/), and their tests too: change both together. npm pack copies the skill from skills/localhost-mcp into the package.