ghostex-cli

A guide for using Ghostex and its gx command-line tool to manage projects, workspaces, terminal sessions, agents, automations, and board items.

In plain words
What is it for?
It helps inspect Ghostex state, create and manage agent sessions, send prompts, schedule automations, use quick actions, and diagnose the server.
Why use it?
It reduces mistakes by requiring the current CLI help and exact resource identifiers to be checked before taking actions.

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/maddada/ghostex/ghostex-cli
Any agent
npx skills add maddada/Ghostex --skill ghostex-cli
Clone the repo
git clone --depth 1 https://github.com/maddada/Ghostex

Made for: Claude Code, Codex.

Per session 135 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 678 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. 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.00135 $0.00678
Opus 5 $0.00068 $0.00339
Sonnet 5 $0.00027 $0.00136
Haiku 4.5 $0.00014 $0.00068

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

Security

Grade A, and why

ghostex-cli scanned grade A with 0 findings 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 2d 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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/ghostex-cli/SKILL.md · 80 lines

How it starts

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

ghostex-cli

Use Ghostex's CLI help as the source of truth instead of relying on remembered command names or flags.

Core Workflow

  1. Read the current command catalog:

    ghostex --help
    
  2. Read focused help when the catalog points to it:

    ghostex automations --help
    ghostex quick-actions --help
    ghostex browser --help
    ghostex server --help
    
  3. Inspect current state before choosing a target. Prefer JSON where offered:

    ghostex sessions --json
    ghostex state
    
  4. Act on an exact project, session, group, automation, or run id. Prefer ids from JSON output over titles, aliases, or whichever project is focused.

  5. Re-read the relevant state or use the command's assertion/wait operation to verify the requested result.

Routing

Everyday Ghostex work — sessions, orchestration, automations, quick actions, chat queues, prompt history, server, diagnostics — is covered by the CLI help above. Route to a specialized skill only when its domain applies:

  • Use $ghostex-embedded-browser-use for browser panes inside Ghostex.
  • Use $ghostex-browser-use for supported external browser page content.
  • Use $ghostex-computer-use for native desktop application control.
  • Use $ghostex-manage-beads for Project Board bead workflows through the machine-installed bd CLI.
  • Use $ghostex-fable-56-orchestration for the Fable-planned, Codex-implemented, Fable-verified multi-pane pipeline.
  • Use $ghostex-auto-rename-session when asked to generate a session title.
  • Use $ghostex-move-codex-session to fork a Codex session into another folder.

Keep using this skill's inspect, act, and verify loop alongside the specialized workflow.

Safety

  • Do not guess a command, selector, flag, or JSON shape when current help can provide it.
  • Inspect exact targets before delete, kill, archive, replacement, or bulk operations.
  • Use --token-stdin for temporary remote tokens; do not put secrets in argv.
  • Do not use raw zmx or tmux commands when Ghostex exposes the operation.
  • Do not treat a successful process exit as verification when state can be checked directly.

Read the full file on GitHub · 80 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 2d ago First seen · 80 lines · 135 tokens per session scan A b6f6dead1222

Subscribe to this mod's changes

ghostex-cli is a skill published in the GitHub repository maddada/Ghostex (714 stars, last pushed 2d ago), licensed MIT. It adds 135 tokens to every session and 678 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it A with 0 findings. 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

kanban-code

Inspect cards, delegate work to subagents, orchestrate Claude sessions, and chat with other agents over Kanban Code's channels. Use whenever the user mentions Kanban Code, asks you to spawn or fork a subagent, asks you to coordinate with another running Claude, or is working inside a card's tmux session and wants to…

langwatch/kanban-code · 97 tokens

setup-okf-matt-skills

Configure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.

evist0/okf-matt-skills · 43 tokens

project-spine

Use when the user mentions AGENTS.md, CLAUDE.md, copilot-instructions, Cursor rules, project brief, context for coding agents, agency kickoff, onboarding a new project, or asks "how do I set up Project Spine". This is the orientation skill — reach for it FIRST when the user's intent involves Project Spine, then chain…

PetriLahdelma/project-spine · 80 tokens

03-architect

Realize the system architecture — turn architecture-constraints + sprint REQs (+ 02's design contract) into a lean arc42/C4 system.md, MADR ADRs, and per-feature specs with gradeable Verification Contracts, all referencing REQs. Second skill to run Reconcile, first via a context-isolated subagent: challenges…

IncommensurableHubris/fullstack-director · 218 tokens

scrum-master

Agent team role for Scrum Master facilitation, coaching, and servant leadership. Use when the user asks to facilitate scrum events, coach a team on self-management, resolve impediments, run retrospectives, improve team processes, or address scrum anti-patterns. Owns the "how we work" - ensures the team applies scrum…

krzysztofsurdy/code-virtuoso · 78 tokens

role-dev

Use when exactly one approved work package (WORK card) should be implemented — including as a DEV subagent in autonomous-loop. Not for scope decisions, reviews, or when no approved card exists.

BechsteinDigital/claude-shiploop · 42 tokens