LOCAL COMMANDER / OPEN SOURCE

Open-source edition

A free, MIT-licensed MCP server that gives your AI client controlled access to one computer. It runs next to the AI client that starts it and needs no account.

MIT license Updated

At a glance

  • Free and MIT licensed, with the source on GitHub.
  • One computer, inside the folders you choose.
  • No Local Commander account, and no connection to localcmd.app.
  • The hosted Local Commander service is a separate product. The difference is below.

What it does

Your AI client starts the server on your computer and talks to it over stdio, or you run it in Docker. The server gives the client tools to:

  • read, search and edit files inside the folders you choose;
  • see Git status, changes and history;
  • run developer commands from an allowlist, such as git, node, npm and python, with separate arguments;
  • start long-running dev processes and read their output;
  • send HTTP requests to services on localhost.

Secret files such as .env and private keys are blocked by default. The server sends no telemetry. It is not a sandbox: an allowed program runs with your account's permissions. For stronger isolation, use the Docker image or a separate account.

Install

  • Claude Desktop: download the .mcpb file from the latest release, open it in Claude Desktop and choose your folders. No Node.js needed.
  • Claude Desktop or Cursor, with Node.js 20 or later: run this, then restart the app: npx -y local-commander-mcp-agent setup --root /path/to/your/projects --client all
  • Any other MCP client: start npx -y local-commander-mcp-agent --stdio /path/to/your/projects
  • Docker: mount your projects into ghcr.io/netbka/local-commander-mcp-agent, for example: docker run -i --rm -v /path/to/your/projects:/workspace/projects ghcr.io/netbka/local-commander-mcp-agent

The edition is also listed in the MCP Registry as io.github.netbka/local-commander-mcp-agent. The README covers configuration, the tool list and the security model.

Open source or hosted

These are two separate products. Neither needs the other.

  • Open-source edition: one computer. Your AI client starts the server on that computer. It works inside the folders you choose and runs commands from its allowlist. No account. Support through GitHub issues.
  • Hosted Local Commander service: ChatGPT, Claude or any MCP client connects to localcmd.app/mcp. It reaches computers that run the Local Commander agent (npx --registry=https://gitlab.com/api/v4/projects/88458751/packages/npm/ local-commander-agent@latest on Windows; macOS and Linux commands) and are paired with your account, including several computers at once. You choose full access to your user account or only the folders you pick. Start from the home page; support is on the support page.

Source and support

Report a bug or ask a question about the open-source edition in GitHub issues. For the hosted service, email Peter Mamrukov at peter.mamrukov@localcmd.app.