Launch and supervise Claude Code or Codex through the CCAM Run API.

MITAuto-check passed

Install Run Agent

skills CLI
$ npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill run-agent -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hoangsonww/Claude-Code-Agent-Monitor run-agent --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/ccam-runner/skills/run-agent .claude/skills/run-agent && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
run-agent
GitHub stars
1.1k
Token cost
~380 tokens
SKILL.md length
154 words
Files
2
Skills in repo
78
Repo updated
First seen
Licence
MIT

At a glance

Launch and supervise Claude Code or Codex through the CCAM Run API.

  • Works in 8 steps: Verify the provider binary → Discover supported models with ccam run… → Confirm the working directory with ccam… → …
  • The user wants to start a monitored agent
  • SKILL.md covers Workflow and Safety
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Run Agent is an agent skill from hoangsonww/Claude-Code-Agent-Monitor. Launch and supervise Claude Code or Codex through the CCAM Run API. Use when the user wants to start a monitored agent, select a model, approval policy, sandbox, or working directory, send a follow-up, inspect live output, resume a native session, or stop a dashboard-launched run.

Its SKILL.md is about 380 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

The repository describes itself as: 🚀 A real-time monitoring dashboard for Claude Code & Codex, built with SQLite3, Node.js, Express, React, Vite, TailwindCSS, & WebSockets. It tracks sessions, agent activity… The licence is MIT.

When your agent uses it

  • The user wants to start a monitored agent
  • Approval policy
  • Working directory
  • Send a follow-up

Example prompts

  • “/run-agent”

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Verify the provider binary
  2. Discover supported models with ccam run models .
  3. Confirm the working directory with ccam run cwds.
  4. Show the exact launch settings before starting. Include provider, prompt,
  5. Start only after user confirmation
  6. Inspect with ccam run list or ccam run get --envelopes.
  7. Send follow-ups with ccam run send --text "..." --provider codex --yes.
  8. Stop with ccam run stop --yes.

What it can do on your machine

Read from SKILL.md and the folder at commit 1a10d68. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Run Agent loads about 380 tokens when it runs. Until then it costs about 73 tokens; SKILL.md has 154 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~73
When it runs · the whole SKILL.md, loaded when a task matches
~380

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hoangsonww/Claude-Code-Agent-Monitor at commit 1a10d68, republished under its MIT licence (© hoangsonww). 154 words, ~380 tokens.

Download SKILL.mdSave it as .claude/skills/run-agent/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
run-agent
description
Launch and supervise Claude Code or Codex through the CCAM Run API. Use when the user wants to start a monitored agent, select a model, approval policy, sandbox, or working directory, send a follow-up, inspect live output, resume a native session, or stop a dashboard-launched run.

Run Agent

Use ccam run against the local dashboard.

Workflow

  1. Verify the provider binary:
    • ccam run binary claude
    • ccam run binary codex
  2. Discover supported models with ccam run models <provider>.
  3. Confirm the working directory with ccam run cwds.
  4. Show the exact launch settings before starting. Include provider, prompt, working directory, model, approval mode, sandbox, and resume session ID.
  5. Start only after user confirmation:
bash
ccam run start --provider codex --cwd /path/to/repo \
  --prompt "Review the current changes" \
  --permission on-request --sandbox workspace-write --yes
  1. Inspect with ccam run list or ccam run get <id> --envelopes.
  2. Send follow-ups with ccam run send <id> --text "..." --provider codex --yes.
  3. Stop with ccam run stop <id> --yes.

Safety

  • Never use danger-full-access unless the user explicitly requests it.
  • Do not start, message, or stop a run without confirmation.
  • Preserve the provider used to start the run when sending messages.
  • Treat run history as evidence. Do not claim completion from process status alone when the final output or persisted session shows an error.

© hoangsonww, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in plugins/ccam-runner/skills/run-agent of hoangsonww/Claude-Code-Agent-Monitor.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 1a10d68

Compare with similar skills

Run Agent next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Run Agent compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Run Agent this skillhoangsonww/Claude-Code-Agent-Monitor1.1k—~380Automated safety check: PassMIT
Shipping and Launch Checklistaddyosmani/agent-skills103k1 repos~2.8kAutomated safety check: PassMIT
Launch Strategyalirezarezvani/claude-skills28k—~1.4kAutomated safety check: PassMIT
HTML Ppt Product Launchnexu-io/open-design100k—~1.3kAutomated safety check: PassApache-2.0
Product Launch Videoheygen-com/hyperframes59k3 repos~8.5kAutomated safety check: NotesApache-2.0
Launch Registryaaron-he-zhu/aaron-marketing-skills2.9k1 repos~1.4kAutomated safety check: PassApache-2.0

Similar skills

  • Shipping and Launch Checklist

    addyosmani/agent-skills

    Prepares a production launch with a pre-launch checklist, monitoring, a staged rollout and a rollback plan so every release is reversible and observable.

    103k GitHub starsUsed in 1 repo~2.8k tokens
    DevOps & CloudAuto-check passed
  • Launch Strategy

    alirezarezvani/claude-skills

    When the user wants to plan a product launch, feature announcement, or release strategy.

    28k GitHub stars~1.4k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • HTML Ppt Product Launch

    nexu-io/open-design

    OpenDesign Teams: a launch-and-adoption proposal for a mid-market design team weighing a switch from closed cloud tools.

    100k GitHub stars~1.3k tokensUpdated today
    Marketing & SEOAuto-check passed
  • Product Launch Video

    heygen-com/hyperframes

    Turns a product URL, script or brief into a launch or promo video built frame by frame in HyperFrames, from brand capture and story design to rendering.

    59k GitHub starsUsed in 3 repos~8.5k tokens
    Media & CreativeAuto-check: notes
  • Launch Registry

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "log this launch", query a launch date/embargo, record a stage transition, or update submissions/outcomes; curates launch facts through the append-only…

    2.9k GitHub starsUsed in 1 repo~1.4k tokens
    Marketing & SEOAuto-check passed
  • Launch Readiness Checklist

    Donchitos/Claude-Code-Game-Studios

    Generates a launch-readiness checklist across code, content, store, marketing, community, infrastructure and legal, scoped to the project and ending in go/no-go sign-offs.

    26k GitHub stars~4.3k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

More from hoangsonww/Claude-Code-Agent-Monitor

All 78 skills in this repo
  • Version Release

    hoangsonww/Claude-Code-Agent-Monitor

    Choose and apply the correct semantic version bump for this repository.

    1.1k GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Budget Set

    hoangsonww/Claude-Code-Agent-Monitor

    Define a spend budget for Claude Code and, optionally, create a cost alert rule that fires when usage crosses the limit, via POST /api/alerts/rules on the Agent Monitor dashboard.

    1.1k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Cache Efficiency

    hoangsonww/Claude-Code-Agent-Monitor

    Analyze prompt-cache effectiveness for Claude Code usage from the Agent Monitor dashboard — cache hit rate (totalcacheread / (totalcacheread + totalinput)), cachewrite vs cacheread reuse, cache-read…

    1.1k GitHub stars~966 tokensUpdated today
    Auto-check passed
  • Cost Breakdown

    hoangsonww/Claude-Code-Agent-Monitor

    Break down Claude Code costs using the Agent Monitor pricing engine.

    1.1k GitHub stars~845 tokensUpdated today
    Auto-check passed
  • Dag Map

    hoangsonww/Claude-Code-Agent-Monitor

    Render the multi-agent orchestration DAG for a session — parent→child subagent edges, tree depth, and fan-out — from the Agent Monitor workflow intelligence API.

    1.1k GitHub stars~564 tokensUpdated today
    Auto-check passed
  • Dashboard Status

    hoangsonww/Claude-Code-Agent-Monitor

    Quick dashboard health and status overview — checks the Agent Monitor API (port 4820), reports session/agent/event counts from /api/stats, confirms WebSocket connectivity, reads the redacted hook…

    1.1k GitHub stars~600 tokensUpdated today
    Auto-check passed

Questions about Run Agent

What does Run Agent do?

Launch and supervise Claude Code or Codex through the CCAM Run API. Run Agent is an agent skill from hoangsonww/Claude-Code-Agent-Monitor. Launch and supervise Claude Code or Codex through the CCAM Run API.

When should I use Run Agent?

Run Agent fits situations like: the user wants to start a monitored agent; approval policy; working directory; send a follow-up.

How do I install Run Agent in Claude Code?

Run `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill run-agent -a claude-code`. Or copy the skill folder (plugins/ccam-runner/skills/run-agent in hoangsonww/Claude-Code-Agent-Monitor) into .claude/skills/run-agent in your project. Claude Code loads it when a task matches its description.

How do I install Run Agent in Codex?

Run `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill run-agent -a codex`. Or copy the skill folder (plugins/ccam-runner/skills/run-agent in hoangsonww/Claude-Code-Agent-Monitor) into .agents/skills/run-agent in your project. Codex loads it when a task matches its description.

Can I use Run Agent in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill run-agent -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/run-agent, .gemini/skills/run-agent, .github/skills/run-agent and .opencode/skills/run-agent in your project.

What does Run Agent need to run?

SKILL.md names no scripts, command-line tools or credentials: Run Agent is instructions for the agent only.

Does Run Agent access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Run Agent safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Run Agent use?

Run Agent is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Run Agent use?

About 380 tokens (SKILL.md is roughly 1.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Run Agent?

Skills that share tags, products or a category with Run Agent: Shipping and Launch Checklist (addyosmani/agent-skills, 103k stars), Launch Strategy (alirezarezvani/claude-skills, 28k stars), HTML Ppt Product Launch (nexu-io/open-design, 100k stars) and Product Launch Video (heygen-com/hyperframes, 59k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Run Agent?

hoangsonww (a GitHub user) maintains it in hoangsonww/Claude-Code-Agent-Monitor, which has 1,054 GitHub stars. The repository holds 78 skills in this directory. The repository was last updated on October 8, 2026.

Source: hoangsonww/Claude-Code-Agent-Monitor on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.