shellx-host

shellx-host is a skill for Claude Code, Codex from martinsbrezauckis/shellx. It costs 89 tokens per session (11,886 once invoked), scanned A, original, MIT.

A set of rules for sessions running inside ShellX, a desktop application that hosts an AI coding session. It describes which ShellX host features are available and when they may be used.

In plain words
What is it for?
Use it only when the session is confirmed to be running in ShellX or when working with ShellX host APIs and surfaces.
Why use it?
It prevents the agent from calling host features that are not available in the current session, such as unsupported terminal requests.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions subagents; runs codex exec; mentions Codex.

Good fit Use it only when the session is confirmed to be running in ShellX or when working with ShellX host APIs and surfaces.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/martinsbrezauckis/shellx/shellx-host
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.

Any agent
npx skills add martinsbrezauckis/shellx --skill shellx-host
Clone the repo
git clone --depth 1 https://github.com/martinsbrezauckis/shellx

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 shellx-host

README.md
[![agentmods](https://agentmods.dev/badge/skills/martinsbrezauckis/shellx/shellx-host/github.svg)](https://agentmods.dev/skills/martinsbrezauckis/shellx/shellx-host)
Your own site
<a href="https://agentmods.dev/skills/martinsbrezauckis/shellx/shellx-host"><img src="https://agentmods.dev/badge/skills/martinsbrezauckis/shellx/shellx-host/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for shellx-host

Your own site · 80×15
<a href="https://agentmods.dev/skills/martinsbrezauckis/shellx/shellx-host"><img src="https://agentmods.dev/badge/skills/martinsbrezauckis/shellx/shellx-host.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 89 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 11,886 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 10 findings, up to high

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • high Tool Misuse · line 513
    Tool parameters are crafted to achieve unintended or unsafe behavior. Parameter abuse can bypass intended safety checks (e.g. shell=True, --force, dangerous glob patterns).
    Fix: Validate all tool parameters against an allowlist. Reject dangerous parameter values (shell=True, --force, -rf /) and use safe defaults.
  • high Tool Misuse · line 636
    Tool parameters are crafted to achieve unintended or unsafe behavior. Parameter abuse can bypass intended safety checks (e.g. shell=True, --force, dangerous glob patterns).
    Fix: Validate all tool parameters against an allowlist. Reject dangerous parameter values (shell=True, --force, -rf /) and use safe defaults.
  • high Tool Misuse · line 640
    Tool parameters are crafted to achieve unintended or unsafe behavior. Parameter abuse can bypass intended safety checks (e.g. shell=True, --force, dangerous glob patterns).
    Fix: Validate all tool parameters against an allowlist. Reject dangerous parameter values (shell=True, --force, -rf /) and use safe defaults.
  • medium Rogue Agent · line 368
    Skill establishes unauthorized persistence across sessions via cron jobs, startup scripts, or state files. Session persistence allows an attacker to maintain access beyond the current interaction.
    Fix: Remove any persistence mechanisms (cron jobs, startup scripts, state files). Skills should not maintain state across sessions without explicit user consent.
  • medium Agent Snooping · line 486
    Skill enumerates or reads other installed skills. Access to other skills' SKILL.md files or the skills directory reveals prompt instructions, capabilities, and secrets that should be invisible to peer skills.
    Fix: Remove all code or instructions that list or read other skills' files or directories. Skills should operate independently; cross-skill access is a privilege escalation.
  • medium Rogue Agent · line 533
    Skill establishes unauthorized persistence across sessions via cron jobs, startup scripts, or state files. Session persistence allows an attacker to maintain access beyond the current interaction.
    Fix: Remove any persistence mechanisms (cron jobs, startup scripts, state files). Skills should not maintain state across sessions without explicit user consent.
  • medium MCP Rug Pull · line 692
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium MCP Rug Pull · line 699
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium Excessive Agency · line 723
    Skill enables autonomous high-impact decisions without human-in-the-loop verification. Critical operations (destructive commands, financial transactions, data deletion) should require explicit user confirmation.
    Fix: Add human-in-the-loop confirmation for destructive, irreversible, or high-impact operations. Never auto-execute commands that modify files, send data, or alter system state.
  • medium Excessive Agency · line 749
    Skill enables autonomous high-impact decisions without human-in-the-loop verification. Critical operations (destructive commands, financial transactions, data deletion) should require explicit user confirmation.
    Fix: Add human-in-the-loop confirmation for destructive, irreversible, or high-impact operations. Never auto-execute commands that modify files, send data, or alter system state.
How audits are shown
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.1 $0.00089 $0.11886
Opus 5.5 $0.00036 $0.04754
Sonnet 5.5 $0.00018 $0.02377
Haiku 4.5 $0.00009 $0.01189

Measured 1mo ago against content hash f180cd7666a5, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

shellx-host scanned grade A 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 1mo 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.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

The user may drive YOU through this API from outside (curl, scripts,
skills/shellx-host/SKILL.md · 847 lines

How it starts

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

ShellX host session

Activation precondition

Use this skill only after positive evidence that the current session is hosted inside ShellX. Valid evidence is explicit ShellX ACP/session metadata in the current prompt or runtime, advertised shellx-host-http__* or grok-shell-host__* host tools, or an explicit user request about ShellX host APIs or surfaces. Global skill availability, a ShellX repository or product name, WSL/Windows context, SSH access, or an ordinary cross-host task is not evidence. If this precondition is absent, stop using this skill and continue with the normal agent tools.

shellX is a Tauri 2 desktop application hosting this grok session over ACP stdio. Assume more than a plain CLI, but only use host surfaces when they help.

1. ACP terminals are unavailable

Current ShellX builds always advertise clientCapabilities.terminal: false and unconditionally rejects provider-originated terminal/* ACP requests with JSON-RPC -32601. Do not retry those calls. Use the provider's native tools or the ShellX Agent host tool for supervised work instead.

The interactive Terminal panel visible to the user is a separate, operator-owned portable-pty surface. Its existence does not enable ACP terminal access for an agent.

2. Vault — mediated secrets and grants

ShellX Vault is the ShellX secret authority. Agents plan from safe metadata, then ask for mediated use. Do not ask for raw secret values and do not copy secrets into chat. If Vault is manually locked, ask the user to unlock it in the Vault panel before retrying grant-backed work.

Access via the host MCP server. In many shellX sessions the same host tools are advertised with both grok-shell-host__ and shellx-host-http__ qualified names. Prefer shellx-host-http__... for mutating or tab-aware tools when it is advertised because that transport carries the active tab and permission gate. Use grok-shell-host__... for read-only discovery or as the local fallback.

If shellx-host-http__capabilities_summary or grok-shell-host__capabilities_summary is advertised, call it directly for a compact current tool map before broad tool discovery. Only eight compact entry tools are advertised by default: capabilities_summary, search_tool, host_read, host_act, browser_read, browser_act, cut_read, and cut_act. Use targeted search_tool queries for an exact hidden Host action schema, then pass the action name and its exact fields through host_read { action, params } for read-class operations or permission-gated host_act { action, params } for mutations and external side effects. Prefer the shellx-host-http__ qualified gateway when advertised. The names in the Vault and Host maps below are action names for that routing flow, not additional always-advertised tools. Avoid full_inventory unless debugging tool-schema drift, because the result is large and Grok may store it as a session artifact instead of showing it clearly in chat. Browser actions use their dedicated browser_read and browser_act gateways instead. ShellX Cut discovery and execution use cut_read and cut_act; Cut's generated verb catalog stays behind that compact pair.

Read the full file on GitHub · 847 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. 1mo ago First seen · 847 lines · 89 tokens per session scan A f180cd7666a5

Subscribe to this mod's changes

shellx-host is a skill published in the GitHub repository martinsbrezauckis/shellx (21 stars, last pushed 7d ago), licensed MIT. It adds 89 tokens to every session and 11,886 once invoked, about $0.0004 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.