Back to the catalog

noyap

No yap. Minimal code + minimal narration for coding agents.

Open source Open in the app JSON README (API)

About

No yap. Minimal code + minimal narration for coding agents.

Details

Kind
Plugins
Topic
No topic detected
Publisher
harjjotsinghh
Origin
gemini
Category
ferramentas
Version
0.2.1
Last push
2026-08-11T06:16:19Z
Repository state
ativo
Language
Python
License
MIT
Added
2026-08-30 14:13:39
Updated
2026-08-30 14:13:39
Origin id
harjjotsinghh/noyap

README

# noyap

**No yap. Ship the smallest correct change. Shut up about it.**

Portable [Agent Skills](https://agentskills.io) package: **minimal narration** + **minimal correct code** in one skill.

| Axis | What it controls | Similar to |
|---|---|---|
| **Mouth** | Near-zero narration, preambles, tours, closing offers | [caveman](https://github.com/JuliusBrussee/caveman) |
| **Hands** | YAGNI, soft LOC budgets, anti-golf, surgical diffs | [ponytail](https://github.com/DietrichGebert/ponytail) |
| **Dial** | `silent` (default) · `brief` · `off` + one-shot `why?` | overrides |

noyap does **not** disable model reasoning. It reduces chatter, scope, tool sprawl, LOC, and tokens. **Correctness and safety always win.**

---

## Install

```bash
# One command (skills + always-on pin into the current project)
npx @harjjotsinghh/noyap --project .

# Full skill body as always-on (more tokens)
npx @harjjotsinghh/noyap --project . --full

# Or skills CLI + pin
npx skills add HarjjotSinghh/noyap
npx @harjjotsinghh/noyap --agents-only --project .
```

Claude Code:

```text
/plugin marketplace add HarjjotSinghh/noyap
/plugin install noyap@noyap
```

Full matrix: **[INSTALL.md](INSTALL.md)** · Help: `npx @harjjotsinghh/noyap --help`

---

## Modes

| Mode | Say | Behavior |
|---|---|---|
| **silent** (default) | `noyap` / `just code` | Diff + path line or `Done.` |
| **brief** | `noyap: brief` | Silent + ≤2 short lines |
| **off** | `noyap: off` / `verbose` | Suspended |
| one-shot | `why?` | Full explanation of last change, then resume |

---

## vs ponytail / caveman

| | caveman | ponytail | **noyap** |
|---|---|---|---|
| Shrinks prose | ✅ | — | ✅ |
| Shrinks code / scope | — | ✅ | ✅ |
| Soft LOC + anti-golf | — | partial | ✅ |
| Speculative “for later” refuse | — | ladder | ✅ hard rule |
| Multi-provider scaffold refuse | — | partial | ✅ hard rule |
| silent / brief / off | levels | lite/full/ultra | ✅ |
| Always-on auto-pin | varies | AGENTS.md | ✅ `npx` / installer |
| Hooks / heavy plugin stack | heavy | heavy | **none** |

Use caveman+ponytail if you want those brands. Use **noyap** for one portable skill covering both halves.

More: [docs/compare.md](docs/compare.md)

---

## Benchmarks

**Primary (n=3, evals 1/7/10, Grok 4.5):**  
[benchmarks/results/n3-20260811T055638Z/COMPARISON.md](benchmarks/results/n3-20260811T055638Z/COMPARISON.md)

| arm (median) | success | out_tok vs base | total_tok vs base |
|---|--:|--:|--:|
| **noyap** | **89%** | **−61%** | **−49%** |
| ponytail | 67% | −39%* | −10%* |
| caveman | 44% | −22%* | +16%* |

\*approx from medians vs baseline in that stamp. **noyap alone hit 100% on multi-auth YAGNI (n=3).**

**Also:** single-shot full suite [20260811T053548Z](benchmarks/results/20260811T053548Z/COMPARISON.md) · real package `sindresorhus/is` [real-20260811T055638Z](benchmarks/results/real-20260811T055638Z/COMPARISON.md)

| Published elsewhere (different engines/repos — **not** interchangeable) | Source |
|---|---|
| Ponytail −54% LOC / −22% tokens (Claude Code · Haiku · FastAPI template) | [ponytail agentic](https://github.com/DietrichGebert/ponytail/blob/main/benchmarks/results/2026-06-18-agentic.md) |
| Caveman −65% chat output · −8.5% agentic (JetBrains) | [caveman](https://github.com/JuliusBrussee/caveman) |

**Do not treat our Grok % as equal to ponytail’s Claude %.** Same metric names only.

Reproduce: [benchmarks/README.md](benchmarks/README.md)

---

## License

[MIT](LICENSE)

More