Agent skill

Neru Add CLI Command

by y3owk1n in y3owk1n/neru

Add a Neru CLI command or flag: cobra command in internal/cli, IPC handler in internal/app/ipcctrl, service/mode work behind it, man pages, and docs/reference/cli.md.

MITAuto-check passedTesting & QA

Install Neru Add CLI Command

skills CLI
$ npx skills add y3owk1n/neru --skill neru-add-cli-command -a claude-code

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

GitHub CLI
$ gh skill install y3owk1n/neru neru-add-cli-command --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/y3owk1n/neru.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/neru-add-cli-command .claude/skills/neru-add-cli-command && 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
neru-add-cli-command
GitHub stars
793
Token cost
~843 tokens
SKILL.md length
399 words
Files
2
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Add a Neru CLI command or flag: cobra command in internal/cli, IPC handler in internal/app/ipcctrl, service/mode work behind it, man pages, and docs/reference/cli.md.

  • Works in 6 steps: Cobra command in internal/cli/.go,… → IPC transport is already generic… → IPC handler in internal/app/ipcctrl.… → …
  • Changing user-facing commands
  • SKILL.md covers The chain, Mode flags are different, Tests and Verify
  • Calls just

What it does

Neru Add CLI Command is an agent skill from y3owk1n/neru. Add a Neru CLI command or flag: cobra command in internal/cli, IPC handler in internal/app/ipcctrl, service/mode work behind it, man pages, and docs/reference/cli.md. Use when adding or changing user-facing commands, subcommands, or flags. Not for config.toml options.

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

It sits in Testing & QA. It works with macOS. The repository describes itself as: Hints, grids and vim keys for your whole desktop. Built for macOS, linux and windows, natively. The licence is MIT.

When your agent uses it

  • Changing user-facing commands

Example prompts

  • “/neru-add-cli-command”

Workflow steps

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

  1. Cobra command in internal/cli/.go, registered in an init()
  2. IPC transport is already generic (internal/adapter/ipc); you only add
  3. IPC handler in internal/app/ipcctrl. Handlers register into
  4. The actual work lives in internal/app/services/* or a mode, never in
  5. Man pages: regenerate with just genman (backed by ./cmd/genman).
  6. Docs: update docs/reference/cli.md. It is the single home for CLI reference

What it can do on your machine

Read from SKILL.md and the folder at commit 3f3a6f5. 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:

    • just

    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

Neru Add CLI Command loads about 843 tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 399 words of instructions outside code blocks.

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

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 y3owk1n/neru at commit 3f3a6f5, republished under its MIT licence (© y3owk1n). 399 words, ~843 tokens.

Download SKILL.mdSave it as .claude/skills/neru-add-cli-command/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
neru-add-cli-command
description
Add a Neru CLI command or flag: cobra command in internal/cli, IPC handler in internal/app/ipcctrl, service/mode work behind it, man pages, and docs/reference/cli.md. Use when adding or changing user-facing commands, subcommands, or flags. Not for config.toml options.

Adding a CLI command to Neru

Neru is a daemon plus a thin CLI: almost every command just serializes an IPC request to the running daemon over its per-user Unix socket or Windows named pipe. A new command therefore touches three layers plus docs — skipping the IPC layer and calling app code directly from internal/cli is wrong even when it compiles.

The chain

  1. Cobra command in internal/cli/<name>.go, registered in an init() like its siblings. Mode-shaped commands (hints/grid/scroll variants) go through BuildModeCommand(ModeConfig{...}) in command_builders.go instead of hand-rolling cobra — look at hints.go first. Long help text follows the house style: prose, then flag explanations, then an Examples: block.
  2. IPC transport is already generic (internal/adapter/ipc); you only add an action string. Keep the wire shape in one place and reuse existing request helpers in internal/cli/cliutil.
  3. IPC handler in internal/app/ipcctrl. Handlers register into Controller.Handlers via the sub-controller for their family (lifecycle, modes, actions, info, overlay, scroll, …) — extend the matching RegisterHandlers, don't bolt a case onto the controller.
  4. The actual work lives in internal/app/services/* or a mode, never in the handler. Handlers parse, delegate, and shape the ipc.Response.
  5. Man pages: regenerate with just genman (backed by ./cmd/genman). Cobra metadata is the source — if the man page reads wrong, fix the command's Short/Long, not the output.
  6. Docs: update docs/reference/cli.md. It is the single home for CLI reference facts.
Show full SKILL.md (171 more words)Show less

Mode flags are different

A flag on a mode command (hints --action left_click) is not registered by hand. It is one entry in the descriptor table in internal/domain/modecmd, carrying its own parse, its own render, and the modes that accept it — that entry is what offers the flag on the command line, what the daemon and the config validator read it with, and what writes its row in the reference.

After adding, removing or re-wording one, run just genflagref to rewrite the generated region of docs/reference/cli.md. An architecture test (internal/architecture/mode_flag_contract_test.go) fails while a descriptor is unregistered or missing from that region, and while a mode command offers a flag the table never declared.

Tests

  • Command wiring and flag parsing: follow the table-driven patterns in internal/cli/cli_test.go / *_internal_test.go.
  • Handler behavior: internal/app/ipcctrl/*_test.go with port mocks from internal/ports/mocks — assert the response shape and that the right service call happened, not internals.
  • Anything platform-gated must degrade with derrors.CodeNotSupported, and a contract test pins that (root AGENTS.md, "Hard rules").

Verify

bash
just build
./bin/neru <command> --help     # against a running daemon: ./bin/neru launch
just genman

Then the standard pre-commit gate from AGENTS.md.

© y3owk1n, 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 .agents/skills/neru-add-cli-command of y3owk1n/neru.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 3f3a6f5

Compare with similar skills

Neru Add CLI Command 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.

Neru Add CLI Command compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Neru Add CLI Command this skilly3owk1n/neru793—~843Automated safety check: PassMIT
Apple Container Test RunnerRustPython/RustPython22k—~467Automated safety check: PassMIT
OpenLogi Device Fixture ContributionAprilNEA/OpenLogi23k—~1.2kAutomated safety check: PassApache-2.0
Cherry Studio Regression TestsCherryHQ/cherry-studio52k—~1.2kAutomated safety check: PassAGPL-3.0
Parallels macOS VM Labsteipete/agent-scripts7.3k—~1.8kAutomated safety check: PassMIT
Macios CI Failure Inspectordotnet/macios2.9k—~2.3kAutomated safety check: PassCustom licence

Similar skills

  • Apple Container Test Runner

    RustPython/RustPython

    Runs RustPython tests inside a Linux container built with Apple's container CLI, so macOS users can compare Linux results with their local ones.

    22k GitHub stars~467 tokensUpdated today
    Testing & QAAuto-check passed
  • Guides recording, privacy review and offline verification of OpenLogi device fixtures with the fixture contribute and verify commands, without treating replay as proof of hardware behavior.

    23k GitHub stars~1.2k tokensUpdated today
    Testing & QAAuto-check passed
  • Cherry Studio Regression Tests

    CherryHQ/cherry-studio

    Runs Cherry Studio's critical-path regression suite as deterministic Playwright E2E tests through a GitHub workflow on macOS and Windows runners.

    52k GitHub stars~1.2k tokensUpdated today
    Testing & QAAuto-check passed
  • Parallels macOS VM Lab

    steipete/agent-scripts

    Uses a clean Parallels macOS VM to test GUI automation, TCC permission prompts and screenshot tools like Peekaboo, verifying results from outside the guest.

    7.3k GitHub stars~1.8k tokensUpdated 4 days ago
    Testing & QAAuto-check passed
  • Official

    Investigate and triage CI failures for dotnet/macios from Azure DevOps build URLs.

    2.9k GitHub stars~2.3k tokensUpdated today
    Testing & QAAuto-check passed
  • Kane CLI Browser Testing

    LambdaTest/kane-cli

    Drives a real browser through the kane-cli tool and designs requirement-linked test suites from a PRD or a plain description, with mobile and cloud-grid runs.

    248 GitHub stars~8.4k tokensUpdated today
    Testing & QAAuto-check passed

More from y3owk1n/neru

  • Add or change a Neru config.toml option end to end: struct field, shared and platform defaults, validation, examples, docs, and hot-reload behavior.

    793 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Implement or stub Neru functionality for a specific OS/backend: port contract, build-tagged file slots, factory wiring, CodeNotSupported stubs, capability matrix, contract tests, and the docs…

    793 GitHub stars~713 tokensUpdated today
    Auto-check passed
  • Neru Ask

    y3owk1n/neru

    Answer a Neru user's question about what Neru does, which command, flag, or config key does a thing, why something does not work, or what to try next, from the help, man pages, and docs of their…

    793 GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Neru Create PR

    y3owk1n/neru

    Commit working changes and open a Neru pull request the maintainer's way: conventional commit subjects, a PR title written for the changelog, the just ci gate, and the repo PR template filled…

    793 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Neru File Issue

    y3owk1n/neru

    File a Neru bug report or feature request that matches the repo's issue forms: duplicate check first, every required field filled with real diagnostics, correct labels.

    793 GitHub stars~890 tokensUpdated today
    Auto-check passed
  • Neru Setup Config

    y3owk1n/neru

    Set up or change a user's Neru config.toml: find or create the file, bind or disable hotkeys, tune hints, grids, or scroll, add per-app overrides, macros, or declared modes, set up the login…

    793 GitHub stars~2.4k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Neru Add CLI Command

What does Neru Add CLI Command do?

Add a Neru CLI command or flag: cobra command in internal/cli, IPC handler in internal/app/ipcctrl, service/mode work behind it, man pages, and docs/reference/cli.md. Neru Add CLI Command is an agent skill from y3owk1n/neru.md.

When should I use Neru Add CLI Command?

Neru Add CLI Command fits situations like: changing user-facing commands.

How do I install Neru Add CLI Command in Claude Code?

Run `npx skills add y3owk1n/neru --skill neru-add-cli-command -a claude-code`. Or copy the skill folder (.agents/skills/neru-add-cli-command in y3owk1n/neru) into .claude/skills/neru-add-cli-command in your project. Claude Code loads it when a task matches its description.

How do I install Neru Add CLI Command in Codex?

Run `npx skills add y3owk1n/neru --skill neru-add-cli-command -a codex`. Or copy the skill folder (.agents/skills/neru-add-cli-command in y3owk1n/neru) into .agents/skills/neru-add-cli-command in your project. Codex loads it when a task matches its description.

Can I use Neru Add CLI Command 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 y3owk1n/neru --skill neru-add-cli-command -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/neru-add-cli-command, .gemini/skills/neru-add-cli-command, .github/skills/neru-add-cli-command and .opencode/skills/neru-add-cli-command in your project.

What does Neru Add CLI Command need to run?

Going by SKILL.md and its folder, Neru Add CLI Command needs the command-line tools its instructions call (just).

Does Neru Add CLI Command 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 Neru Add CLI Command 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 Neru Add CLI Command use?

Neru Add CLI Command 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 Neru Add CLI Command use?

About 843 tokens (SKILL.md is roughly 3.4k 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 Neru Add CLI Command?

Skills that share tags, products or a category with Neru Add CLI Command: Apple Container Test Runner (RustPython/RustPython, 22k stars), OpenLogi Device Fixture Contribution (AprilNEA/OpenLogi, 23k stars), Cherry Studio Regression Tests (CherryHQ/cherry-studio, 52k stars) and Parallels macOS VM Lab (steipete/agent-scripts, 7.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Neru Add CLI Command?

y3owk1n (a GitHub user) maintains it in y3owk1n/neru, which has 793 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 8, 2026.

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