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

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/martinsbrezauckis/shellx/shellx-host
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.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.svg" alt="Measured on agentmods" 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. 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.00089 $0.11886
Opus 5 $0.00044 $0.05943
Sonnet 5 $0.00018 $0.02377
Haiku 4.5 $0.00009 $0.01189

Measured 4d ago against content hash f180cd7666a5, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, 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 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.

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. 4d 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 (20 stars, last pushed 11d ago), licensed MIT. It adds 89 tokens to every session and 11,886 once invoked, about $0.0004 per session on Opus 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.

Related

Other skills, from other repositories

qa-cli-mcp-api

Select and run explicitly requested, risk-based QA for Anarlog's CLI, webhooks, stdio MCP, hosted Cloud API, and remote MCP. Test only affected lanes unless comprehensive coverage is requested.

fastrepl/anarlog · 47 tokens

product-update-newsletter

Draft, update, or audit a crisp, changelog-grounded Anarlog product-update newsletter in Loops (app.loops.so) for a desktop release. Use after the changelog is merged, when asked to draft, revise, or pre-send check the release announcement email.

fastrepl/anarlog · 62 tokens

sqlite-schema-design

Design or review schemas for crates/cloudsync using SQLite Sync constraints, not generic SQLite advice. Use when adding synced tables, changing synced columns, or planning CloudSync-safe migrations.

fastrepl/anarlog · 42 tokens

release-new-version

Release a new desktop stable version for Anarlog. Use when asked to cut, publish, or prepare a new stable desktop release after checking and merging the changelog.

fastrepl/anarlog · 38 tokens

fix-ready-prs

Inspect every open non-draft PR for CI failures and unresolved Cursor Bugbot findings, then fix them on the existing PR branches. Use when asked to check active PRs, triage ready PRs, fix CI, or address Bugbot comments.

fastrepl/anarlog · 55 tokens

reactive-sqlite-ui

Build SQLite-backed reactive UI in apps/desktop using stable patterns for reads, selection, forms, writes, and loading states. Use when implementing or reviewing screens built on useDrizzleLiveQuery and SQLite mutations.

fastrepl/anarlog · 53 tokens