mcpbeat Sign in

Codeman MCP Server

local only

Codeman runs on your own machine — the client starts it, so there is no endpoint to ping. 6 558 installs a week from npm. Last commit 16 Oct 2026.

Start, prompt and read AI coding agent sessions (Claude Code, Codex, Gemini CLI and more) in Codeman

Installs per day peak 1 950 · avg 564 · +168% w/w
a month agotoday
6 558
Installs / week
npm · aicodeman
797
Stars
12 open issues
16 Oct 2026
Last commit
from GitHub
MIT
License
TypeScript

What the code does

We read the source, 21 h ago · rules ccca72095570

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Installs itself into autostart install.sh:1539
    local plist="$HOME/Library/LaunchAgents/com.codeman.web.plist"
A line of code looks encrypted src/web/public/constants.js:2103
  /(^|[\s"'`(\[{<>=,])((?![^\s"'`<>|;&()[\]{}=,\n\x00-\x1f]*:\/\/)(?:~\/|[^\s"'`<>|;&()[\]{}=,\/~\n\x00-\x1f])[^\s"'`<>|;&()[\]{}=,\n\x00-\x1f]*\.(?:log|txt|json|markdown|md|ya?ml|csv|xml|sh|py|tsx|ts|jsx|js|mjs|cjs|css|html?|toml|ini|sql|png|jpe?g|gif|webp|avif|bmp|ico|svg|pdf|d…
Checks whether it runs in a sandbox src/web/self-update.ts:462
  return process.env.CODEMAN_IN_CONTAINER === '1' || existsSync('/.dockerenv');
Runs a command on install [пакет] package.json:1
postinstall: node scripts/postinstall.js
        execSync(`tmux kill-session -t "${this.checkMuxName}" 2>/dev/null`, { timeout: 3000 });
Asks for container control access docker/docker-compose.yaml:71
        target: /var/run/docker.sock
Touches key and credential files src/web/sensitive-path.ts:64
  /\/\.npmrc$/,

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add codeman -- npx -y aicodeman
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "codeman": {
      "args": [
        "-y",
        "aicodeman"
      ],
      "command": "npx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.codeman]
command = "npx"
args = ["-y", "aicodeman"]
.cursor/mcp.json
{
  "mcpServers": {
    "codeman": {
      "args": [
        "-y",
        "aicodeman"
      ],
      "command": "npx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "codeman": {
      "args": [
        "-y",
        "aicodeman"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: CODEMAN_API_URL (Where your Codeman server runs, for example https://127.0.0.1:3000. Never guessed.), CODEMAN_PASSWORD (Codeman's HTTP Basic password, when the server has one.). The author declared them in the registry entry; get the values from the project itself.

Alternatives to Codeman

same job, measured the same way
showagent
by aytzey

Search, resume and convert AI coding sessions (Claude Code, Codex, Gemini, OpenCode, Pi) over MCP.

local only
reevesagents
by mertkayacs

Spawn, read and steer AI coding CLIs (Claude Code, Codex, Kimi and more) in local tmux windows.

600 installs/wk local only
Tokmeter — AI Agent Usage & Cost
by sriinnu

Tokens and cost for Claude Code, Codex and 22 more AI coding agents, from local session files.

218 installs/wk local only
AI R
by pro-target

Read local AI agent sessions (Claude Code, Codex, OpenCode, Antigravity, Pi): intents, plans, tools

65 installs/wk local only
Baton
by kasabeh

Pass the baton between coding agents: convert sessions across Claude Code, OpenCode, Codex & more.

95 installs/wk local only
SkillGild
by skillgild

Search and run hosted AI agent skills for Claude Code, Codex, Cursor and Gemini CLI.

local only
Pathmark
by hacksurvivor

Local-first intent and provenance for Codex, Claude Code, Cursor, Gemini CLI, and MCP agents.

134 installs/wk local only
magents
by abnegate

Shared session bus for Claude, Codex, Copilot, Cursor, Gemini, AGY, Grok, and OpenCode.

local only

Codeman — questions

Answers built from our own checks of this server.

Why is there no uptime for Codeman?
Codeman runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package aicodeman was installed 6 558 times last week.
How do I connect Codeman?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls aicodeman straight from npm; nothing to host, nothing to sign up for.
How many people use Codeman?
The npm package aicodeman was installed 6 558 times in the last week. Week over week that is +168%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Codeman open source?
Yes — it is published under the MIT licence, written in TypeScript, 797 stars on GitHub and 12 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.