lazarus-mcp
A universal agent supervisor with hot-reload support, multi-agent orchestration, and TUI dashboard for AI coding agents.
Features
- Hot-Reload - Restart your AI agent to pick up MCP server changes without losing terminal context
Power your agent
Install from the publisher. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
No packaged release in the registry yet. Follow the repository README.
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchFrom the publisher
A universal agent supervisor with hot-reload support, multi-agent orchestration, and TUI dashboard for AI coding agents.
MCP server for restarting Claude Code. Allows Claude code to restart itself if it's updating an MCP and running that MCP server at the same time.
.mcp.json with backup/restore on exit# Clone and install
git clone https://github.com/Brainwires/lazarus-mcp.git
cd lazarus-mcp
cargo install --path .
# Run Claude Code through the wrapper
lazarus-mcp claude
That's it! The wrapper automatically:
.mcp.json (restored on exit)--continue on restarts to preserve session contextTerminal
└── lazarus-mcp claude (wrapper)
│
├── Modifies .mcp.json (backup at .mcp.json.aegis-backup)
├── Shared State (/tmp/lazarus-mcp-state-{pid}.json)
│
└── claude --dangerously-skip-permissions
│
└── MCP servers (from .mcp.json)
└── lazarus-mcp --mcp-server
├── restart_claude
└── agent_spawn/list/status/await/stop
On Exit (normal, signal, or crash):
└── Restores .mcp.json from backup
Second Terminal (optional)
└── lazarus-mcp --dashboard
└── TUI showing real-time status
# Claude Code
lazarus-mcp claude
lazarus-mcp claude --continue
lazarus-mcp claude -p "Help me with..."
# Aider
lazarus-mcp aider
lazarus-mcp aider --model gpt-4
# Cursor
lazarus-mcp cursor
Monitor a running wrapper with the TUI dashboard:
# In terminal 1: Run the agent
lazarus-mcp claude
# In terminal 2: Open dashboard (auto-detects running wrapper)
lazarus-mcp --dashboard
# Or specify a wrapper PID
lazarus-mcp --dashboard 12345
Dashboard panels:
Keybindings:
q / Esc - Quit dashboardh / ? - Show helpTab / Shift+Tab - Switch panelsr - Restart agentj / k or arrows - Scroll logRestart the AI coding agent to reconnect all MCP servers.
Parameters:
- reason (optional): Reason for the restart (for logging)
- prompt (optional): A prompt to pass as a command-line argument on restart
Example:
restart_claude(reason: "MCP server updated", prompt: "Continue where we left off")
Get status information about the wrapper, agent process, and configuration.
Spawn and manage background agents that work autonomously on tasks.
Spawn a background agent to work on a task.
Parameters:
- description: The task for the agent to work on
- agent_type (optional): "claude", "aider", or "cursor" (default: "claude")
- working_directory (optional): Directory for the agent to work in
- max_iterations (optional): Maximum iterations before stopping
Returns: agent_id
List all active background agents with their status.
Get detailed status of a specific agent.
Parameters:
- agent_id: The ID of the agent to check
Wait for a background agent to complete and get its result.
Parameters:
- agent_id: The ID of the agent to wait for
- timeout_secs (optional): Maximum time to wait
Stop a running background agent.
Parameters:
- agent_id: The ID of the agent to stop
Get statistics about the agent pool (max agents, active, running, completed, failed).
List all currently held file locks by agents (for coordination).
lazarus-mcp claude.mcp.json to .mcp.json.aegis-backup.mcp.jsonrestart_claude is called:
/tmp/lazarus-mcp-{pid}--continue flag.mcp.json is restored from backupNote: The restart_claude tool detects if running under the wrapper. If started without the wrapper, it returns an error message explaining how to use lazarus-mcp.
lazarus-mcp injects itself into .mcp.json with automatic backup/restore:
.mcp.json.aegis-backup (previous crash recovery).mcp.json to .mcp.json.aegis-backup.mcp.json.mcp.jsonSafety features:
restart_claude tool detects this and returns helpful error# Build and install to ~/.cargo/bin
cargo install --path .
# Check version
lazarus-mcp --version
If you prefer to configure MCP manually instead of auto-injection:
{
"mcpServers": {
"lazarus-mcp": {
"command": "lazarus-mcp",
"args": ["--mcp-server"]
}
}
}
alias claude='lazarus-mcp claude'
alias aegis-dashboard='lazarus-mcp --dashboard'
Linux only (uses /proc filesystem).
MIT
MCP server for restarting Claude Code. Allows Claude code to restart itself if it's updating an MCP and running that MCP server at the same time.
Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
No required environment variable is listed on this record.
Lazarus runs locally over stdio.
Last checked 2026-10-28. MCP server for restarting Claude Code. Allows Claude code to restart itself if it's updating an MCP and running that MCP server at the same time.