New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Kumo CLI

by AstraFoundry in AstraFoundry/KumoApp

Drive Kumo from coding agents and automation through the kumo command-line interface.

AGPL-3.0Auto-check passedMobile

Install Kumo CLI

skills CLI
$ npx skills add AstraFoundry/KumoApp --skill kumo-cli -a claude-code

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

GitHub CLI
$ gh skill install AstraFoundry/KumoApp kumo-cli --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/AstraFoundry/KumoApp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/Sources/KumoCoreKit/Resources/KumoAgentSkills/skills/kumo-cli .claude/skills/kumo-cli && 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
kumo-cli
GitHub stars
290
Token cost
~758 tokens
SKILL.md length
373 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Drive Kumo from coding agents and automation through the kumo command-line interface.

  • Works in 4 steps: Start with kumo doctor --json for a… → Use focused read commands such as kumo… → Use --dry-run before commands that can… → …
  • Troubleshooting Kumo
  • SKILL.md covers Quick Start, When to Use, Output Contract and Discoverability, plus 4 more sections
  • Calls swift and bash

What it does

Kumo CLI is an agent skill from AstraFoundry/KumoApp. Drive Kumo from coding agents and automation through the kumo command-line interface. Use when starting, stopping, inspecting, configuring, or troubleshooting Kumo, Mihomo runtime state, profiles, proxies, system proxy, TUN, service mode, or Kumo agent skill installation.

Its SKILL.md is about 760 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering iOS development. It works with macOS. The repository describes itself as: A calm, native macOS client for the Mihomo proxy core, built with SwiftUI and a shared agent-friendly CLI. The licence is AGPL-3.0.

When your agent uses it

  • Troubleshooting Kumo
  • Mihomo runtime state
  • Kumo agent skill installation

Example prompts

  • “/kumo-cli”

Workflow steps

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

  1. Start with kumo doctor --json for a broad snapshot.
  2. Use focused read commands such as kumo status --json, kumo proxies --json, or kumo service status --json.
  3. Use --dry-run before commands that can change macOS settings or installed skills.
  4. After a write command, re-run the narrow status command to verify the result.

What it can do on your machine

Read from SKILL.md and the folder at commit 990ff36. 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

    Shell commands in SKILL.md call:

    • swift
    • 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

Kumo CLI loads about 758 tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 373 words of instructions outside code blocks.

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

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 AstraFoundry/KumoApp at commit 990ff36, republished under its AGPL-3.0 licence (© AstraFoundry). 373 words, ~758 tokens.

Download SKILL.mdSave it as .claude/skills/kumo-cli/SKILL.md (or your agent's skills folder).
name
kumo-cli
description
Drive Kumo from coding agents and automation through the `kumo` command-line interface. Use when starting, stopping, inspecting, configuring, or troubleshooting Kumo, Mihomo runtime state, profiles, proxies, system proxy, TUN, service mode, or Kumo agent skill installation.

Kumo CLI

Quick Start

Run kumo doctor --json first when diagnosing state. Use --json whenever parsing output. Use the installed kumo command, which should resolve to /usr/local/bin/kumo and then to Kumo.app/Contents/Helpers/kumo. swift run kumo is only for source-tree development checks.

When to Use

  • Control Kumo lifecycle, mode, profiles, proxies, system proxy, TUN, or service mode.
  • Inspect current runtime state before changing configuration.
  • Install, update, or inspect Kumo's bundled agent skills.

Output Contract

  • JSON responses use { "ok": true|false, "data": ..., "error": ... } and always include all three keys.
  • Exit code 0 means success.
  • Exit code 1 means failure; read error when ok is false.
  • Prefer stable command names and JSON fields over parsing human-readable output.
  • --json stdout is always plain JSON with no ANSI color, progress, or logs.
  • Diagnostics and log output go to stderr in text mode.

Discoverability

  • kumo --help or kumo -h shows common commands.
  • kumo -l shows long command usage.
  • kumo <command> -h and kumo help <term> show focused help.
  • kumo completion zsh|bash|fish emits shell completion scripts.

Command Workflow

  1. Start with kumo doctor --json for a broad snapshot.
  2. Use focused read commands such as kumo status --json, kumo proxies --json, or kumo service status --json.
  3. Use --dry-run before commands that can change macOS settings or installed skills.
  4. After a write command, re-run the narrow status command to verify the result.
Show full SKILL.md (149 more words)Show less

Skill Installation Commands

  • kumo skills status --json
  • kumo skills status --agent cursor --json
  • kumo skills install --agent codex --dry-run --json
  • kumo skills install --agent all --scope global --json
  • kumo skills uninstall --agent cursor --scope global --dry-run --json

Supported agents are cursor, claude, codex, gemini, agents, and all where documented. codex and gemini do not support project scope.

Logging Commands

  • kumo logs path
  • kumo logs cli --limit 5
  • kumo logs clean --dry-run --json

Use --loglevel <silent|error|warn|notice|http|info|verbose|silly> to adjust diagnostic verbosity. Prefer --silent --json for automation that only needs machine-readable results.

Safety Rules

  • Do not edit generated runtime YAML unless the user explicitly asks for raw file changes.
  • Prefer kumo or the Kumo app over direct writes to Kumo state files.
  • Do not pass --force to skill installation unless the user intends to replace an existing skill directory.
  • When working inside the Kumo repository, use docs/interfaces/cli-agent-control.md for the detailed CLI contract.

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

Files

Just SKILL.md in Sources/KumoCoreKit/Resources/KumoAgentSkills/skills/kumo-cli of AstraFoundry/KumoApp.

Open the folder on GitHubat commit 990ff36

Compare with similar skills

Kumo CLI 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.

Kumo CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Kumo CLI this skillAstraFoundry/KumoApp290—~758Automated safety check: PassAGPL-3.0
Hig Project Contextraintree-technology/hig-doctor1425 repos~1.2kAutomated safety check: PassMIT
Hig Components Contentraintree-technology/hig-doctor1425 repos~1.3kAutomated safety check: PassMIT
macOS Auto Updatefayazara/macos-app-skills672—~1.8kAutomated safety check: PassNone
API Explorationsozercan/kaset2.4k—~454Automated safety check: PassMIT
Dev Loop Packagingsozercan/kaset2.4k—~388Automated safety check: PassMIT

Similar skills

  • Hig Project Context

    raintree-technology/hig-doctor

    Create or update a shared Apple design context document that other HIG skills use to tailor guidance.

    142 GitHub starsUsed in 5 repos~1.2k tokens
    MobileAuto-check passed

  • Hig Components Content

    raintree-technology/hig-doctor

    Apple Human Interface Guidelines for content display components.

    142 GitHub starsUsed in 5 repos~1.3k tokens
    MobileAuto-check passed

  • macOS Auto Update

    fayazara/macos-app-skills

    Add Sparkle auto-update support to a native macOS app. An agent skill from fayazara/macos-app-skills.

    672 GitHub stars~1.8k tokensUpdated 4 mo ago
    MobileAuto-check passed

  • API Exploration

    sozercan/kaset

    A skill your agent uses when a task needs a new or modified YouTube Music API call, response parser validation, authenticated endpoint investigation, or fixture capture; explore endpoints with swift…

    2.4k GitHub stars~454 tokensUpdated 4 days ago
    MobileAuto-check passed

  • Dev Loop Packaging

    sozercan/kaset

    A skill your agent uses when you need a fresh packaged .app bundle, a fast build-package-relaunch loop, or a packaged runtime repro for Kaset instead of a compile-only verification.

    2.4k GitHub stars~388 tokensUpdated 4 days ago
    MobileAuto-check passed

  • App It

    Christian-Katzmann/app-it

    Turn a local project or a hosted web app (including a published Claude Artifact URL) into a macOS Dock-launchable .app.

    216 GitHub stars~2.4k tokensUpdated 7 days ago
    MobileAuto-check passed

More from AstraFoundry/KumoApp

  • Liquid Glass Design

    AstraFoundry/KumoApp

    iOS 26 Liquid Glass design system — dynamic glass material with blur, reflection, and interactive morphing for SwiftUI, UIKit, and WidgetKit.

    290 GitHub starsUsed in 5 repos~2.3k tokens
    Auto-check passed

  • Swiftui Animation

    AstraFoundry/KumoApp

    Implement, review, or improve SwiftUI animations and transitions.

    290 GitHub stars~4.1k tokensUpdated 4 mo ago
    Auto-check passed

  • Add Component

    AstraFoundry/KumoApp

    Add a SwiftUI component from ShipSwift recipes. An agent skill from AstraFoundry/KumoApp.

    290 GitHub stars~737 tokensUpdated 4 mo ago
    Auto-check passed

  • Build Feature

    AstraFoundry/KumoApp

    Build an iOS feature using ShipSwift component recipes. An agent skill from AstraFoundry/KumoApp.

    290 GitHub stars~632 tokensUpdated 4 mo ago
    Auto-check passed

  • Explore Recipes

    AstraFoundry/KumoApp

    Explore and browse available ShipSwift recipes. An agent skill from AstraFoundry/KumoApp.

    290 GitHub stars~621 tokensUpdated 4 mo ago
    Auto-check passed

Works with

Categories

Questions about Kumo CLI

What does Kumo CLI do?

Drive Kumo from coding agents and automation through the kumo command-line interface. Kumo CLI is an agent skill from AstraFoundry/KumoApp. Drive Kumo from coding agents and automation through the kumo command-line interface.

When should I use Kumo CLI?

Kumo CLI fits situations like: troubleshooting Kumo; mihomo runtime state; kumo agent skill installation.

How do I install Kumo CLI in Claude Code?

Run `npx skills add AstraFoundry/KumoApp --skill kumo-cli -a claude-code`. Or copy the skill folder (Sources/KumoCoreKit/Resources/KumoAgentSkills/skills/kumo-cli in AstraFoundry/KumoApp) into .claude/skills/kumo-cli in your project. Claude Code loads it when a task matches its description.

How do I install Kumo CLI in Codex?

Run `npx skills add AstraFoundry/KumoApp --skill kumo-cli -a codex`. Or copy the skill folder (Sources/KumoCoreKit/Resources/KumoAgentSkills/skills/kumo-cli in AstraFoundry/KumoApp) into .agents/skills/kumo-cli in your project. Codex loads it when a task matches its description.

Can I use Kumo CLI 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 AstraFoundry/KumoApp --skill kumo-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kumo-cli, .gemini/skills/kumo-cli, .github/skills/kumo-cli and .opencode/skills/kumo-cli in your project.

What does Kumo CLI need to run?

Going by SKILL.md and its folder, Kumo CLI needs the command-line tools its instructions call (swift and bash).

Does Kumo CLI 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 Kumo CLI 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 Kumo CLI use?

Kumo CLI is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Kumo CLI use?

About 758 tokens (SKILL.md is roughly 3k 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 Kumo CLI?

Skills that share tags, products or a category with Kumo CLI: Hig Project Context (raintree-technology/hig-doctor, 142 stars), Hig Components Content (raintree-technology/hig-doctor, 142 stars), macOS Auto Update (fayazara/macos-app-skills, 672 stars) and API Exploration (sozercan/kaset, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kumo CLI?

AstraFoundry (a GitHub organization) maintains it in AstraFoundry/KumoApp, which has 290 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on June 5, 2026.

Source: AstraFoundry/KumoApp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.