Skip to content

Commit 2a830e9

Browse files
ahmadbilaldevahmadbilaldev
committed
Merge remote-tracking branch 'origin/main' into pr-1004
Co-authored-by: CommandCodeBot <noreply@commandcode.ai> # Conflicts: # mods/registry.json
2 parents 687039e + d52c3cc commit 2a830e9

3 files changed

Lines changed: 192 additions & 7 deletions

File tree

‎mods/README.md‎

Lines changed: 14 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,11 @@
44
[mods hub](https://commandcode.ai/mods). The hub reads it live, so a merged PR here lists
55
your mod within minutes — no website deploy.
66

7-
Two ways a mod gets listed:
8-
9-
1. **Publish to npm with the `cmd-mod` keyword** — it is discovered automatically, no PR needed.
10-
2. **Open a PR against `registry.json`** — for git-only mods, or to add richer metadata. This is that path.
7+
Every listed mod has a reviewed entry in `registry.json`. Publish your mod to npm
8+
or GitHub, then open a PR against this file. Publishing an npm package with the
9+
`cmd-mod` keyword helps maintainers discover it for review; it does not list it
10+
automatically. Existing GitHub entries continue to load from the file without
11+
an npm review or a website deployment.
1112

1213
## Add your mod
1314

@@ -37,10 +38,17 @@ against [`registry.schema.json`](./registry.schema.json).
3738
| `author` | yes | `{ "name": "…" }` required; optional `github` / `url` link the name |
3839
| `kinds` | yes | one or more of `tool` `command` `hook` `provider` `renderer` `flag` |
3940
| `repo` | no | a GitHub URL also enables the star count |
40-
| `npm` | no | links the entry to its npm package for live download counts |
41+
| `npm` | no | names its published npm package for live metadata and download counts |
4142
| `tags` | no | lowercase slugs, searchable |
4243
| `addedAt` | no | `YYYY-MM-DD`, used for the "Newest" sort |
4344

44-
`official` and the top-level `hidden` list are maintainer-only — leave them out of your PR.
45+
`official`, `featured`, and the top-level `hidden` list are maintainer-only — leave them out of your PR.
4546

4647
Keep the array valid JSON (no trailing commas) and one mod per PR where you can, so review stays quick.
48+
49+
For an npm mod, set both `source` and `npm` to the full package name, including
50+
its scope. Give scoped packages a separate unique lowercase `name` matching the
51+
schema. The entry supplies the description, author, categories, and tags; npm
52+
adds the latest version, publish date, and monthly downloads. A GitHub `repo`
53+
adds its star count. Maintainers review the published package code before
54+
listing it. Review is not a sandbox or a guarantee about future releases.

‎mods/registry.json‎

Lines changed: 173 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,19 @@
33
"version": 1,
44
"hidden": [],
55
"mods": [
6+
{
7+
"name": "cmd-mod-jev-nudge",
8+
"source": "cmd-mod-jev-nudge",
9+
"description": "Agents stop too early. At every stop this mod asks Jev whether a nudge would help, and keeps the agent going when work is left. It won't nudge when the agent is waiting on you.",
10+
"author": { "name": "Ahmad Awais", "github": "ahmadawais" },
11+
"repo": "https://github.com/CommandCodeAI/cmd-mod-jev-nudge",
12+
"npm": "cmd-mod-jev-nudge",
13+
"kinds": ["hook", "flag"],
14+
"tags": ["jev", "stop-hook", "agent"],
15+
"official": true,
16+
"featured": true,
17+
"addedAt": "2026-09-22"
18+
},
619
{
720
"name": "cmd-mod-hi",
821
"source": "cmd-mod-hi",
@@ -196,6 +209,166 @@
196209
],
197210
"addedAt": "2026-10-13"
198211
},
212+
{
213+
"name": "commandcode-hud-zh",
214+
"source": "Albert-Lsk/commandcode-hud-zh",
215+
"description": "Chinese-language context HUD showing token usage, compaction health, large-result alerts, and session spend. Adapts to narrow terminals.",
216+
"author": { "name": "ALSKai", "github": "Albert-Lsk" },
217+
"repo": "https://github.com/Albert-Lsk/commandcode-hud-zh",
218+
"kinds": ["command", "hook", "flag"],
219+
"tags": ["hud", "context", "monitoring", "chinese"],
220+
"addedAt": "2026-10-03"
221+
},
222+
{
223+
"name": "cmd-mod-fuzzy-search",
224+
"source": "cmd-mod-fuzzy-search",
225+
"description": "Fast, frecency-ranked fuzzy file and content search backed by FFF",
226+
"author": {
227+
"name": "Ahmad Bilal",
228+
"github": "ahmadbilaldev"
229+
},
230+
"repo": "https://github.com/ahmadbilaldev/cmd-mod-fuzzy-search",
231+
"npm": "cmd-mod-fuzzy-search",
232+
"kinds": [
233+
"tool",
234+
"command"
235+
],
236+
"tags": [
237+
"search",
238+
"files",
239+
"fuzzy"
240+
],
241+
"addedAt": "2026-10-20"
242+
},
243+
{
244+
"name": "cmd-mod-lint-feedback",
245+
"source": "cmd-mod-lint-feedback",
246+
"description": "Run linters and type checkers after every edit and feed the problems back to the agent",
247+
"author": {
248+
"name": "Ahmad Bilal",
249+
"github": "ahmadbilaldev"
250+
},
251+
"repo": "https://github.com/ahmadbilaldev/cmd-mod-lint-feedback",
252+
"npm": "cmd-mod-lint-feedback",
253+
"kinds": [
254+
"tool",
255+
"command",
256+
"hook"
257+
],
258+
"tags": [
259+
"lint",
260+
"diagnostics",
261+
"typecheck"
262+
],
263+
"addedAt": "2026-10-20"
264+
},
265+
{
266+
"name": "cmd-mod-notify",
267+
"source": "cmd-mod-notify",
268+
"description": "Desktop notifications and sounds when the agent finishes, fails, or needs you",
269+
"author": {
270+
"name": "Ahmad Bilal",
271+
"github": "ahmadbilaldev"
272+
},
273+
"repo": "https://github.com/ahmadbilaldev/cmd-mod-notify",
274+
"npm": "cmd-mod-notify",
275+
"kinds": [
276+
"tool",
277+
"command",
278+
"hook"
279+
],
280+
"tags": [
281+
"notifications",
282+
"sound",
283+
"desktop"
284+
],
285+
"addedAt": "2026-10-20"
286+
},
287+
{
288+
"name": "cmd-mod-output-trimmer",
289+
"source": "cmd-mod-output-trimmer",
290+
"description": "Fewer tokens on tool output: rtk command rewriting and compaction of build, test, git, lint, and search output",
291+
"author": {
292+
"name": "Ahmad Bilal",
293+
"github": "ahmadbilaldev"
294+
},
295+
"repo": "https://github.com/ahmadbilaldev/cmd-mod-output-trimmer",
296+
"npm": "cmd-mod-output-trimmer",
297+
"kinds": [
298+
"command",
299+
"hook"
300+
],
301+
"tags": [
302+
"tokens",
303+
"output",
304+
"rtk"
305+
],
306+
"addedAt": "2026-10-20"
307+
},
308+
{
309+
"name": "cmd-mod-powerline-status",
310+
"source": "cmd-mod-powerline-status",
311+
"description": "A powerline-style status row for Command Code: model, effort, path, git, context, and tokens",
312+
"author": {
313+
"name": "Ahmad Bilal",
314+
"github": "ahmadbilaldev"
315+
},
316+
"repo": "https://github.com/ahmadbilaldev/cmd-mod-powerline-status",
317+
"npm": "cmd-mod-powerline-status",
318+
"kinds": [
319+
"command",
320+
"hook"
321+
],
322+
"tags": [
323+
"statusline",
324+
"powerline",
325+
"ui"
326+
],
327+
"addedAt": "2026-10-20"
328+
},
329+
{
330+
"name": "cmd-mod-rule-compaction",
331+
"source": "cmd-mod-rule-compaction",
332+
"description": "Compact long conversations by rules, with no model call, keeping the prompt cache intact",
333+
"author": {
334+
"name": "Ahmad Bilal",
335+
"github": "ahmadbilaldev"
336+
},
337+
"repo": "https://github.com/ahmadbilaldev/cmd-mod-rule-compaction",
338+
"npm": "cmd-mod-rule-compaction",
339+
"kinds": [
340+
"tool",
341+
"command",
342+
"hook"
343+
],
344+
"tags": [
345+
"compaction",
346+
"context",
347+
"tokens"
348+
],
349+
"addedAt": "2026-10-20"
350+
},
351+
{
352+
"name": "cmd-mod-rules-warden",
353+
"source": "cmd-mod-rules-warden",
354+
"description": "Hold writes that break your project rules, and send unproven \"done\" claims back for a check",
355+
"author": {
356+
"name": "Ahmad Bilal",
357+
"github": "ahmadbilaldev"
358+
},
359+
"repo": "https://github.com/ahmadbilaldev/cmd-mod-rules-warden",
360+
"npm": "cmd-mod-rules-warden",
361+
"kinds": [
362+
"command",
363+
"hook"
364+
],
365+
"tags": [
366+
"rules",
367+
"guardrails",
368+
"verification"
369+
],
370+
"addedAt": "2026-10-20"
371+
},
199372
{
200373
"name": "cmd-compaction-guard",
201374
"source": "aska-digital/cmd-compaction-guard",

‎mods/registry.schema.json‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"$schema": "http://json-schema.org/draft-07/schema#",
33
"title": "Command Code mods registry",
4-
"description": "The curated layer behind commandcode.ai/mods. Packages published to npm with the `cmd-mod` keyword are listed automatically; this file adds git-only mods, richer metadata over npm entries (matched by `npm`), and the `hidden` list for moderation. The resolved list is served at https://commandcode.ai/mods.json.",
4+
"description": "The reviewed list behind commandcode.ai/mods. Each npm or GitHub mod requires a registry entry; publishing to npm alone does not list a package. The `npm` field enables live metadata and downloads, and `hidden` excludes entries for moderation. The resolved list is served at https://commandcode.ai/mods.json.",
55
"type": "object",
66
"required": ["version", "mods"],
77
"properties": {
@@ -84,6 +84,10 @@
8484
"type": "boolean",
8585
"description": "Maintained by the Command Code team."
8686
},
87+
"featured": {
88+
"type": "boolean",
89+
"description": "Pinned to the top of the hub. Maintainer-only."
90+
},
8791
"addedAt": {
8892
"type": "string",
8993
"format": "date",

0 commit comments

Comments
 (0)