cli-commands

cli-commands is a cursor rule for Cursor from AxiosLeo/node-koapp. It costs 0 tokens per session (883 once invoked), scanned A, original, MIT.

A command-line interface for creating and developing Koapp projects. It provides commands for starting projects, generating code, and handling HTTP-related utilities.

In plain words
What is it for?
Use it to initialize a new application, generate components, run HTTP utilities, and develop or extend commands stored in the project's commands directory.
Why use it?
It removes the need to assemble the initial project structure and configuration by hand. Generated projects include common service, database, package, and Docker setup files.

Cursor rule for Cursor

Written for Cursor: a Cursor rule (.mdc). Also seen: installed under .agents/ (shared by several agents).

Good fit Use it to initialize a new application, generate components, run HTTP utilities, and develop or extend commands stored in the project's commands directory.

Compare 6 cursor rules from other repositories ↓
Install with agentmods
npx agentmods add rules/axiosleo/node-koapp/cli-commands
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.

Clone the repo
git clone --depth 1 https://github.com/AxiosLeo/node-koapp

Made for: Cursor.

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 cli-commands

README.md
[![agentmods](https://agentmods.dev/badge/rules/axiosleo/node-koapp/cli-commands/github.svg)](https://agentmods.dev/rules/axiosleo/node-koapp/cli-commands)
Your own site
<a href="https://agentmods.dev/rules/axiosleo/node-koapp/cli-commands"><img src="https://agentmods.dev/badge/rules/axiosleo/node-koapp/cli-commands/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for cli-commands

Your own site · 80×15
<a href="https://agentmods.dev/rules/axiosleo/node-koapp/cli-commands"><img src="https://agentmods.dev/badge/rules/axiosleo/node-koapp/cli-commands.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 0 Nothing until a file matches its globs; then the whole rule loads.
When invoked 883 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.00000 $0.00883
Opus 5.5 $0.00000 $0.00353
Sonnet 5.5 $0.00000 $0.00177
Haiku 4.5 $0.00000 $0.00088

Measured today against content hash a28bd0eb474e, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

cli-commands 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 today.

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.

.agents/rules/cli-commands.mdc · 88 lines

How it starts

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

CLI Command Patterns

CLI Entry Point

The main CLI is defined in bin/koapp.js and provides:

  • koapp init <app-name> - Initialize new project
  • koapp http [dir] - Serve a static directory over HTTP
  • koapp skills -i <cursor|claude> - Install the bundled AI skills into a project

Command Structure

Commands are implemented in the commands/ directory and auto-loaded by @axiosleo/cli-tool through the commands_dir option:

Shared, testable helpers live in src/cli/ (e.g. src/cli/pnpm.js for Corepack / pnpm detection, src/cli/pkg.js for package-manager detection). Keep command files thin and put logic there.

Project Initialization

The init command asks which template to generate (or takes -t):

npx @axiosleo/koapp init <app-name> [-d <optional-dir>] [-t simple-ts|simple-js|monorepo]
Template Source Result
simple-ts (default) assets/simple/ts/ One TypeScript HTTP service and sample routes. No database.
simple-js assets/simple/js/ The same service in CommonJS. No compile step.
monorepo assets/monorepo/ pnpm workspace: apps/services (admin Session auth, /openapi Bearer Api-Key, SQLite), packages/commands, bin/<app-name>.js

Every template also receives .agents/skills/ copied from assets/skills/. After writing files, init probes for pnpm (offering to install the pinned version) and then offers to run pnpm install and pnpm dev.

Template selection and file rendering live in src/cli/scaffold.js so they can be tested without a prompt.

Template System

Templates use the .tmpl extension and are processed during project generation:

  • assets/simple/{ts,js}/**/*.tmpl and assets/monorepo/**/*.tmpl - rendered with _render_with_file, which replaces ${name} with the app name; the .tmpl suffix is stripped on output
  • assets/monorepo/bin/monoapp.js.tmpl - renamed to bin/<app-name>.js (monorepo template only)
  • assets/skills/ - copied verbatim into <app>/.agents/skills/ (_sync reback must stay off, or the copy writes back into this package)

Read the full file on GitHub · 88 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. today Changed · +18 lines a28bd0eb474e
  2. 1mo ago First seen · 70 lines · 0 tokens per session scan A fce0aba5c550

Subscribe to this mod's changes

cli-commands is a cursor rule published in the GitHub repository AxiosLeo/node-koapp (143 stars, last pushed yesterday), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 883 tokens. 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.