[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79K4KV8JS8DXMZC5YCF67XJ":3,"skill-same:01M79K4KV8JS8DXMZC5YCF67XJ":44},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M79K4KV8JS8DXMZC5YCF67XJ","agent-workspace-linux",null,"Use when a task needs an isolated hidden Linux desktop or workspace-owned browser: GUI app QA, web\u002Fbrowser\u002Fshopping automation, sandboxed app observation, or stale workspace cleanup. Routes agent-workspace-linux MCP tools on demand. Does NOT apply to host desktop\u002FChrome control, generic MCP setup, or pure code\u002Ffile edits.","aleafofwutong\u002Fcodex_for_ubuntu","aleafofwutong","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F183128716?v=4","01M79K4D17B01YHEWF0XJQ03PB","firmiana","01M79K4D1R6SNV4KE4MZFH0S53",0,"MIT","https:\u002F\u002Fgithub.com\u002Faleafofwutong\u002Fcodex_for_ubuntu\u002Fblob\u002Fmain\u002Flinux-features\u002Fagent-workspace\u002Fskills\u002Fagent-workspace-linux\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: agent-workspace-linux\ndescription: \"Use when a task needs an isolated hidden Linux desktop or workspace-owned browser: GUI app QA, web\u002Fbrowser\u002Fshopping automation, sandboxed app observation, or stale workspace cleanup. Routes agent-workspace-linux MCP tools on demand. Does NOT apply to host desktop\u002FChrome control, generic MCP setup, or pure code\u002Ffile edits.\"\n---\n\n# agent-workspace-linux\n\nDrive an isolated, agent-owned Linux desktop and workspace-owned browser through\nthe `agent-workspace-linux` MCP server. The workspace runs apps, browser\nautomation, screenshots, clipboard, and input inside its own hidden display,\nnever the user's real desktop, focus, or host Chrome.\n\nThis skill is the lightweight entry point. The MCP exposes many tools; do not\nload, list, or paste them all up front. Route by phase and ask the host to load\nonly the tool schemas needed for the next action.\n\n## Critical Boundaries\n\n### Use the dedicated Codex for Linux feature page for setup\nCodex for Linux owns Agent Workspace setup through the **Agent Workspaces** page:\nbinary path, page-authored permission rules, permission file mutation,\nReconnect\u002FSmoke test, profile creation, workspace start\u002Fstop, and viewer launch.\nDo not send users to generic MCP settings, general configuration pages, or\n`~\u002F.codex\u002Fconfig.toml` for normal Codex for Linux setup.\n\nSkip unless: the host is Codex for Linux and the task is setup, permission\nchanges, reconnect\u002Frestart, or the workspace tools are unavailable.\n\n### Keep tools progressive\nThe bundled installer is skill-first. `.\u002Finstall.sh` installs this skill under\n`~\u002F.codex\u002Fskills` by default and leaves generic Codex MCP config untouched\nunless the user explicitly chooses `--codex-configure` or `--permissions`.\nFor migration only, `.\u002Finstall.sh --clean-codex-config` removes stale generic\nCodex MCP entries left by older installs; restart or reconnect Codex afterward.\n\nSkip unless: the user asks how to install\u002Fregister the backend or why the tool\nfamily should not be loaded at startup.\n\n### Never target the host desktop\nUse this skill only for the hidden workspace. For the user's real Linux desktop,\nreal Chrome profile, existing tabs, or host focus\u002Fmouse\u002Fkeyboard, use the\nappropriate host-desktop or browser tool instead.\n\nSkip unless: the requested action can run inside the isolated workspace display\nor workspace-owned browser.\n\n## When To Use\n\n- GUI app QA in a throwaway desktop.\n- Browser\u002Fweb\u002Fshopping automation that must not hijack host Chrome.\n- Observation of sandboxed windows, logs, events, screenshots, or artifacts.\n- Cleanup of stale or orphaned agent workspaces.\n\nSkip unless: the user task requires running or driving a real GUI app\u002Fbrowser in\nisolation. For pure code, shell, or file edits, do not start a workspace.\n\n## Permission Model\n\n- **Default**: no MCP ceiling is configured; the host\u002Fclient owns approvals.\n  Call `mcp_permissions` once before mutating to confirm `configured=false`.\n- **Permission ceiling**: `--permissions PATH` or\n  `AGENT_WORKSPACE_PERMISSIONS` caps network, mounts, and app allowlist for the\n  life of that MCP process. It can only be broadened by changing the config and\n  restarting\u002Freconnecting the backend from the owning setup surface.\n- **Live control**: `mcp_control_state` read-only\u002Fpaused\u002Factive is a\n  best-effort runtime control, not the authoritative security boundary.\n- **Real-world actions**: checkout, purchases, account changes, and messages\n  require explicit user approval. Keep drafting separate from final action.\n\nSkip unless: you are about to start a workspace, open a profile, launch\u002Frun an\napp, send input, or act on an external account\u002Fsite.\n\n## Phase Router\n\nAlways orient before mutating.\n\n| Phase | Load only these tools |\n| --- | --- |\n| Orient | `mcp_agent_context`, `mcp_session_brief`, `mcp_task_plan`, `mcp_permissions`, `mcp_action_catalog`, `workspace_doctor`, `workspace_list`, `workspace_status` |\n| Profiles | `profile_list`, `profile_get`, `profile_template`, `profile_put`, `profile_check` |\n| Start | `workspace_start`, `workspace_open_profile` |\n| Observe | `workspace_observe`, `workspace_screenshot`, `workspace_list_windows`, `workspace_active_window`, `workspace_read_app_log`, `workspace_events` |\n| Act | `workspace_launch_app`, `workspace_run_app`, `workspace_click`, `workspace_type_text`, `workspace_key`, `workspace_paste_text`, `workspace_focus_window`, `workspace_close_window` |\n| Browser | `workspace_open_browser`, `workspace_browser_targets`, `workspace_browser_snapshot`, `workspace_browser_navigate`, `workspace_browser_search_results`, `workspace_browser_click` |\n| Viewer\u002Fcontrol | `mcp_control_state`, `mcp_control_update`, `workspace_open_viewer`, `workspace_list_viewers`, `workspace_close_viewer` |\n| Teardown | `workspace_stop`, `workspace_kill_app`, `workspace_cleanup_stale` |\n\nSkip unless: the current phase needs one of the listed capabilities. Do not load\nschemas for later phases until the plan reaches them.\n\n## Safe Workflow\n\n1. Orient: call `mcp_agent_context` or `mcp_session_brief`, then use\n   `mcp_task_plan` for app-QA, browser, observe, or cleanup intent.\n2. Check permissions: call `mcp_permissions` before mutating.\n3. Start: use `workspace_start` with `ack_hidden_workspace=true` and a clear\n   `purpose`, or `workspace_open_profile` for a saved profile.\n4. Observe: use `workspace_observe` or focused screenshot\u002Fwindow\u002Flog\u002Fevent\n   tools before sending input.\n5. Act: launch apps, run commands, click\u002Ftype\u002Fpaste\u002Fkey only inside the\n   workspace.\n6. Stop: use `workspace_stop` when finished; use `workspace_cleanup_stale` for\n   orphaned runtimes.\n\nSkip unless: each step's precondition is visible in the previous tool result\n(workspace id, app id, target window, browser target, or explicit user approval).\n\n## Browser Tasks\n\nUse the workspace-owned browser over its loopback DevTools endpoint. Start with\n`workspace_open_browser`, discover pages with `workspace_browser_targets`, read\nwith `workspace_browser_snapshot` or `workspace_browser_search_results`, then\nnavigate or click with browser tools.\n\nSkip unless: the task is web\u002Fbrowser automation that can run in the isolated\nworkspace. Do not attach to host Chrome, Playwright, or Computer Use as a\nshortcut.\n\n## Do NOT\n\n- Do not dump all MCP tools into the agent context at startup.\n- Do not send users to generic MCP\u002Fconfiguration pages for Codex for Linux\n  Agent Workspace setup.\n- Do not start a workspace without `ack_hidden_workspace=true` and a `purpose`.\n- Do not send input to or screenshot the user's real desktop.\n- Do not perform purchases, checkout, account changes, or sends without explicit\n  user approval.\n- Do not leave workspaces running after the task.\n\n## Example Trajectory\n\nTask: \"QA the settings dialog of myapp.\"\n\n1. `mcp_agent_context` and `mcp_task_plan` for app-QA.\n2. `mcp_permissions` to confirm the active boundary.\n3. `workspace_start` with `ack_hidden_workspace=true` and purpose\n   `\"QA myapp settings\"`.\n4. `workspace_launch_app` with the app command.\n5. `workspace_observe` to find the window.\n6. `workspace_click` \u002F `workspace_type_text` to exercise Settings.\n7. `workspace_screenshot` and `workspace_read_app_log` for evidence.\n8. `workspace_stop`.\n\n## Constraints\n\n- Keep activation low-noise: only use this skill for isolated GUI\u002Fbrowser work.\n- Keep context small: frontmatter loads by default; body loads on activation;\n  tool schemas load on demand.\n- Omit `allowed-tools` intentionally: different hosts namespace MCP tools\n  differently, and the skill routes the full family progressively.\n- Validate with `agnix --target generic|claude-code|cursor|codex|kiro`\n  when changing this file.\n","# agent-workspace-linux\n\nDrive an isolated, agent-owned Linux desktop and workspace-owned browser through\nthe `agent-workspace-linux` MCP server. The workspace runs apps, browser\nautomation, screenshots, clipboard, and input inside its own hidden display,\nnever the user's real desktop, focus, or host Chrome.\n\nThis skill is the lightweight entry point. The MCP exposes many tools; do not\nload, list, or paste them all up front. Route by phase and ask the host to load\nonly the tool schemas needed for the next action.\n\n## Critical Boundaries\n\n### Use the dedicated Codex for Linux feature page for setup\nCodex for Linux owns Agent Workspace setup through the **Agent Workspaces** page:\nbinary path, page-authored permission rules, permission file mutation,\nReconnect\u002FSmoke test, profile creation, workspace start\u002Fstop, and viewer launch.\nDo not send users to generic MCP settings, general configuration pages, or\n`~\u002F.codex\u002Fconfig.toml` for normal Codex for Linux setup.\n\nSkip unless: the host is Codex for Linux and the task is setup, permission\nchanges, reconnect\u002Frestart, or the workspace tools are unavailable.\n\n### Keep tools progressive\nThe bundled installer is skill-first. `.\u002Finstall.sh` installs this skill under\n`~\u002F.codex\u002Fskills` by default and leaves generic Codex MCP config untouched\nunless the user explicitly chooses `--codex-configure` or `--permissions`.\nFor migration only, `.\u002Finstall.sh --clean-codex-config` removes stale generic\nCodex MCP entries left by older installs; restart or reconnect Codex afterward.\n\nSkip unless: the user asks how to install\u002Fregister the backend or why the tool\nfamily should not be loaded at startup.\n\n### Never target the host desktop\nUse this skill only for the hidden workspace. For the user's real Linux desktop,\nreal Chrome profile, existing tabs, or host focus\u002Fmouse\u002Fkeyboard, use the\nappropriate host-desktop or browser tool instead.\n\nSkip unless: the requested action can run inside the isolated workspace display\nor workspace-owned browser.\n\n## When To Use\n\n- GUI app QA in a throwaway desktop.\n- Browser\u002Fweb\u002Fshopping automation that must not hijack host Chrome.\n- Observation of sandboxed windows, logs, events, screenshots, or artifacts.\n- Cleanup of stale or orphaned agent workspaces.\n\nSkip unless: the user task requires running or driving a real GUI app\u002Fbrowser in\nisolation. For pure code, shell, or file edits, do not start a workspace.\n\n## Permission Model\n\n- **Default**: no MCP ceiling is configured; the host\u002Fclient owns approvals.\n  Call `mcp_permissions` once before mutating to confirm `configured=false`.\n- **Permission ceiling**: `--permissions PATH` or\n  `AGENT_WORKSPACE_PERMISSIONS` caps network, mounts, and app allowlist for the\n  life of that MCP process. It can only be broadened by changing the config and\n  restarting\u002Freconnecting the backend from the owning setup surface.\n- **Live control**: `mcp_control_state` read-only\u002Fpaused\u002Factive is a\n  best-effort runtime control, not the authoritative security boundary.\n- **Real-world actions**: checkout, purchases, account changes, and messages\n  require explicit user approval. Keep drafting separate from final action.\n\nSkip unless: you are about to start a workspace, open a profile, launch\u002Frun an\napp, send input, or act on an external account\u002Fsite.\n\n## Phase Router\n\nAlways orient before mutating.\n\n| Phase | Load only these tools |\n| --- | --- |\n| Orient | `mcp_agent_context`, `mcp_session_brief`, `mcp_task_plan`, `mcp_permissions`, `mcp_action_catalog`, `workspace_doctor`, `workspace_list`, `workspace_status` |\n| Profiles | `profile_list`, `profile_get`, `profile_template`, `profile_put`, `profile_check` |\n| Start | `workspace_start`, `workspace_open_profile` |\n| Observe | `workspace_observe`, `workspace_screenshot`, `workspace_list_windows`, `workspace_active_window`, `workspace_read_app_log`, `workspace_events` |\n| Act | `workspace_launch_app`, `workspace_run_app`, `workspace_click`, `workspace_type_text`, `workspace_key`, `workspace_paste_text`, `workspace_focus_window`, `workspace_close_window` |\n| Browser | `workspace_open_browser`, `workspace_browser_targets`, `workspace_browser_snapshot`, `workspace_browser_navigate`, `workspace_browser_search_results`, `workspace_browser_click` |\n| Viewer\u002Fcontrol | `mcp_control_state`, `mcp_control_update`, `workspace_open_viewer`, `workspace_list_viewers`, `workspace_close_viewer` |\n| Teardown | `workspace_stop`, `workspace_kill_app`, `workspace_cleanup_stale` |\n\nSkip unless: the current phase needs one of the listed capabilities. Do not load\nschemas for later phases until the plan reaches them.\n\n## Safe Workflow\n\n1. Orient: call `mcp_agent_context` or `mcp_session_brief`, then use\n   `mcp_task_plan` for app-QA, browser, observe, or cleanup intent.\n2. Check permissions: call `mcp_permissions` before mutating.\n3. Start: use `workspace_start` with `ack_hidden_workspace=true` and a clear\n   `purpose`, or `workspace_open_profile` for a saved profile.\n4. Observe: use `workspace_observe` or focused screenshot\u002Fwindow\u002Flog\u002Fevent\n   tools before sending input.\n5. Act: launch apps, run commands, click\u002Ftype\u002Fpaste\u002Fkey only inside the\n   workspace.\n6. Stop: use `workspace_stop` when finished; use `workspace_cleanup_stale` for\n   orphaned runtimes.\n\nSkip unless: each step's precondition is visible in the previous tool result\n(workspace id, app id, target window, browser target, or explicit user approval).\n\n## Browser Tasks\n\nUse the workspace-owned browser over its loopback DevTools endpoint. Start with\n`workspace_open_browser`, discover pages with `workspace_browser_targets`, read\nwith `workspace_browser_snapshot` or `workspace_browser_search_results`, then\nnavigate or click with browser tools.\n\nSkip unless: the task is web\u002Fbrowser automation that can run in the isolated\nworkspace. Do not attach to host Chrome, Playwright, or Computer Use as a\nshortcut.\n\n## Do NOT\n\n- Do not dump all MCP tools into the agent context at startup.\n- Do not send users to generic MCP\u002Fconfiguration pages for Codex for Linux\n  Agent Workspace setup.\n- Do not start a workspace without `ack_hidden_workspace=true` and a `purpose`.\n- Do not send input to or screenshot the user's real desktop.\n- Do not perform purchases, checkout, account changes, or sends without explicit\n  user approval.\n- Do not leave workspaces running after the task.\n\n## Example Trajectory\n\nTask: \"QA the settings dialog of myapp.\"\n\n1. `mcp_agent_context` and `mcp_task_plan` for app-QA.\n2. `mcp_permissions` to confirm the active boundary.\n3. `workspace_start` with `ack_hidden_workspace=true` and purpose\n   `\"QA myapp settings\"`.\n4. `workspace_launch_app` with the app command.\n5. `workspace_observe` to find the window.\n6. `workspace_click` \u002F `workspace_type_text` to exercise Settings.\n7. `workspace_screenshot` and `workspace_read_app_log` for evidence.\n8. `workspace_stop`.\n\n## Constraints\n\n- Keep activation low-noise: only use this skill for isolated GUI\u002Fbrowser work.\n- Keep context small: frontmatter loads by default; body loads on activation;\n  tool schemas load on demand.\n- Omit `allowed-tools` intentionally: different hosts namespace MCP tools\n  differently, and the skill routes the full family progressively.\n- Validate with `agnix --target generic|claude-code|cursor|codex|kiro`\n  when changing this file.\n",{"name":5,"description":7},"main","87e1b89b85a6a93970e83570d38654cd494c6500","linux-features\u002Fagent-workspace\u002Fskills\u002Fagent-workspace-linux","https:\u002F\u002Fgithub.com\u002Faleafofwutong\u002Fcodex_for_ubuntu","https:\u002F\u002Fgithub.com\u002Faleafofwutong","2026-07-24 08:23:57",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add aleafofwutong\u002Fcodex_for_ubuntu --skill agent-workspace-linux",{"tool":36,"command":37},"bunx","bunx skills add aleafofwutong\u002Fcodex_for_ubuntu --skill agent-workspace-linux",{"tool":39,"command":40},"pnpm","pnpm dlx skills add aleafofwutong\u002Fcodex_for_ubuntu --skill agent-workspace-linux","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Faleafofwutong\u002Fcodex_for_ubuntu\u002Fblob\u002Fmain\u002Flinux-features\u002Fagent-workspace\u002Fskills\u002Fagent-workspace-linux\u002FSKILL.md",true,[],[45,52,59,66,73,80],{"skillNo":46,"name":47,"nameZh":6,"description":48,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":49,"categories":50,"keywords":51,"publishedAt":19},"01M79K50WT51J719YY6PKQNNXX","Unsafe Symlink","Use when testing symlink safety.","https:\u002F\u002Fgithub.com\u002Faleafofwutong\u002Fcodex_for_ubuntu\u002Fblob\u002Fmain\u002Frecord-replay-linux\u002Ftests\u002Ffixtures\u002Fskills\u002Funsafe-symlink\u002FSKILL.md",[],[],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M79K4ZW2XHAXS7DZYGYA1Z17","Mac Only","Use when automating Finder with AppleScript.","https:\u002F\u002Fgithub.com\u002Faleafofwutong\u002Fcodex_for_ubuntu\u002Fblob\u002Fmain\u002Frecord-replay-linux\u002Ftests\u002Ffixtures\u002Fskills\u002Fplatform-macos\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M79K4XNVSNB063QDKVVN0Y45","Instruction Only","Use when answering with reusable written instructions.","https:\u002F\u002Fgithub.com\u002Faleafofwutong\u002Fcodex_for_ubuntu\u002Fblob\u002Fmain\u002Frecord-replay-linux\u002Ftests\u002Ffixtures\u002Fskills\u002Finstruction-only\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M79K4W2TE0KB7QJ7Z01VA6H5","Desktop Act","Use when clicking and typing in a Linux desktop app.","https:\u002F\u002Fgithub.com\u002Faleafofwutong\u002Fcodex_for_ubuntu\u002Fblob\u002Fmain\u002Frecord-replay-linux\u002Ftests\u002Ffixtures\u002Fskills\u002Fdesktop-act\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M79K4V397B122QP3YKQ1RHWZ","Collision Tripwire","Use when testing script handling.","https:\u002F\u002Fgithub.com\u002Faleafofwutong\u002Fcodex_for_ubuntu\u002Fblob\u002Fmain\u002Frecord-replay-linux\u002Ftests\u002Ffixtures\u002Fskills\u002Fcollision-tripwire\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M79K4R6GPK8XGN6NHYA3RSTP","record-and-replay","Use when the user wants Codex to record a Linux desktop or browser workflow and turn it into a reusable skill. Requires the Record & Replay event-stream MCP server.","https:\u002F\u002Fgithub.com\u002Faleafofwutong\u002Fcodex_for_ubuntu\u002Fblob\u002Fmain\u002Flinux-features\u002Frecord-and-replay\u002Fplugin-template\u002Fskills\u002Frecord-and-replay\u002FSKILL.md",[],[]]