@agent-sh/agent-workspace-linux
v0.1.1
Published
Isolated Linux desktop workspaces for AI agents — MCP server binary wrapper.
Downloads
309
Maintainers
Readme
@agent-sh/agent-workspace-linux
npm distribution wrapper for the agent-workspace-linux MCP server — isolated Linux desktop workspaces for AI agents.
Installation
npm install -g @agent-sh/agent-workspace-linuxThe installer automatically downloads the prebuilt binary for your architecture from the matching GitHub Release.
Linux only. x64 (x86_64) and arm64 (aarch64) are supported.
Note —
--ignore-scripts: package managers that skip lifecycle scripts (e.g.pnpmwithignore-scripts=true, some CI setups) will not download the binary automatically. Run the postinstall manually to recover:node $(npm root -g)/@agent-sh/agent-workspace-linux/scripts/postinstall.js
Usage
Once installed, the server is on your PATH (the command stays unscoped):
agent-workspace-linuxIt is an MCP server that speaks JSON-RPC over stdio. For Codex for Linux, prefer the dedicated Agent Workspaces feature page so command paths, permission rules, and reconnect/restart control stay out of the generic MCP settings page. If an older Codex install still shows this backend in generic MCP/configuration pages, remove the stale agent-workspace-linux MCP tables before reconnecting through the feature page. For other MCP clients, wire it into the client config, e.g. for Claude Code:
{
"mcpServers": {
"agent-workspace-linux": {
"command": "agent-workspace-linux",
"args": []
}
}
}Source and full documentation
All source code, tool documentation, and issue tracking are at: https://github.com/agent-sh/agent-workspace-linux
License
MIT
