agent-workspace-linux

agent-workspace-linux is a skill for Claude Code, Codex from ilysenko/codex-desktop-linux. It costs 70 tokens per session (1,728 once invoked), scanned B, original, MIT.

A guide for operating an isolated Linux desktop and browser owned by the agent's workspace. It is meant for observing or testing apps without controlling the user's real computer or browser.

In plain words
What is it for?
Use it for application quality checks, browser automation, shopping tasks, screenshots, clipboard actions, input, or cleaning up an old workspace.
Why use it?
It provides a separate environment for GUI checks and browser tasks while keeping those actions away from the host desktop.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/ilysenko/codex-desktop-linux/agent-workspace-linux
Any agent
npx skills add ilysenko/codex-desktop-linux --skill agent-workspace-linux
Clone the repo
git clone --depth 1 https://github.com/ilysenko/codex-desktop-linux

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for agent-workspace-linux

README.md
[![agentmods](https://agentmods.dev/badge/skills/ilysenko/codex-desktop-linux/agent-workspace-linux.svg)](https://agentmods.dev/skills/ilysenko/codex-desktop-linux/agent-workspace-linux)
Your own site
<a href="https://agentmods.dev/skills/ilysenko/codex-desktop-linux/agent-workspace-linux"><img src="https://agentmods.dev/badge/skills/ilysenko/codex-desktop-linux/agent-workspace-linux.svg" alt="Measured on agentmods" height="20"></a>
Per session 70 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,728 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00070 $0.01728
Opus 5 $0.00035 $0.00864
Sonnet 5 $0.00014 $0.00346
Haiku 4.5 $0.00007 $0.00173

Measured 4d ago against content hash d7667ac34c05, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

agent-workspace-linux scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

`~/.codex/config.toml` for normal Codex for Linux setup.
Origin

Copies of this mod

2 near-identical copies found in the catalogue:

linux-features/agent-workspace/skills/agent-workspace-linux/SKILL.md · 153 lines

How it starts

The opening of the file, as written. The whole thing — 153 lines — stays where its author put it; the contents beside it link to each section on GitHub.

agent-workspace-linux

Drive an isolated, agent-owned Linux desktop and workspace-owned browser through the agent-workspace-linux MCP server. The workspace runs apps, browser automation, screenshots, clipboard, and input inside its own hidden display, never the user's real desktop, focus, or host Chrome.

This skill is the lightweight entry point. The MCP exposes many tools; do not load, list, or paste them all up front. Route by phase and ask the host to load only the tool schemas needed for the next action.

Critical Boundaries

Use the dedicated Codex for Linux feature page for setup

Codex for Linux owns Agent Workspace setup through the Agent Workspaces page: binary path, page-authored permission rules, permission file mutation, Reconnect/Smoke test, profile creation, workspace start/stop, and viewer launch. Do not send users to generic MCP settings, general configuration pages, or ~/.codex/config.toml for normal Codex for Linux setup.

Skip unless: the host is Codex for Linux and the task is setup, permission changes, reconnect/restart, or the workspace tools are unavailable.

Keep tools progressive

The bundled installer is skill-first. ./install.sh installs this skill under ~/.codex/skills by default and leaves generic Codex MCP config untouched unless the user explicitly chooses --codex-configure or --permissions. For migration only, ./install.sh --clean-codex-config removes stale generic Codex MCP entries left by older installs; restart or reconnect Codex afterward.

Skip unless: the user asks how to install/register the backend or why the tool family should not be loaded at startup.

Never target the host desktop

Use this skill only for the hidden workspace. For the user's real Linux desktop, real Chrome profile, existing tabs, or host focus/mouse/keyboard, use the appropriate host-desktop or browser tool instead.

Skip unless: the requested action can run inside the isolated workspace display or workspace-owned browser.

Read the full file on GitHub · 153 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 153 lines · 70 tokens per session scan B d7667ac34c05

Subscribe to this mod's changes

agent-workspace-linux is a skill published in the GitHub repository ilysenko/codex-desktop-linux (3,744 stars, last pushed 2d ago), licensed MIT. It adds 70 tokens to every session and 1,728 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

om-integration-tests

Run and create QA integration tests (Playwright TypeScript), including executing the full suite, converting optional markdown scenarios, and generating new tests from specs or feature descriptions. Defers all environment boot/reuse to the om-prepare-test-env skill and attaches to the shared descriptor it writes. Use…

open-mercato/open-mercato · 99 tokens

separateweb-capture

Capture a URL into a full-page screenshot, cropped UI item PNGs, and a JSON manifest. Use when the user says separateweb capture , asks to capture a website, or wants UI extraction assets without running the SeparateWeb web app.

hashgraph-online/awesome-codex-plugins · 59 tokens

fetch-url-as-markdown

Fetch a web page (URL) and return clean Markdown via local trafilatura, with Exa MCP as a fallback for JS-rendered or anti-bot pages. Use when the user asks to read, fetch, scrape, summarize, or quote a URL — prefer this over the built-in WebFetch tool. Don't use for binary files (PDFs, images, archives) or for…

CodeAlive-AI/ai-driven-development · 90 tokens

chrome-extension

Use when building or shipping a Manifest V3 browser extension and hitting its quirks — service worker dying and losing state, permission warnings, a Chrome Web Store rejection, content-script/worker/popup messaging, or an MV2-to-V3 migration. NOT a generic web app (that is nextjs), NOT a desktop shell (that is…

ericrisco/rsc-harness · 76 tokens

playwright-pro

Production-grade Playwright testing toolkit. Use when the user mentions Playwright tests, end-to-end testing, browser automation, fixing flaky tests, test migration, CI/CD testing, or test suites. Generate tests, fix flaky failures, migrate from Cypress/Selenium, sync with TestRail, run on BrowserStack. 55 templates…

adriannoes/awesome-agentic-ai · 77 tokens

browserstack

Run tests on BrowserStack. Use when user mentions "browserstack", "cross-browser", "cloud testing", "browser matrix", "test on safari", "test on firefox", or "browser compatibility".

adriannoes/awesome-agentic-ai · 44 tokens