marionettejs
A JavaScript library for structured interfaces, with explicit ownership and lifecycle. Built for agent-led development. Canonical Marionette repository; v4 history is preserved on the v4 branch.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/marionettejs/marionette with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/marionettejs/marionette'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/marionettejs--marionette)HTML
<a href="/listings/marionettejs--marionette"><img src="/api/listings/marionettejs--marionette/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 13 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- {
- "name": "marionettejs",
- "owner": {
- "name": "Marionette.js"
- },
- "plugins": [
- {
- "name": "marionette",
- "source": "./plugins/marionette",
- "description": "Build and debug Marionette applications with version-matched documentation."
- }
- ]
- }
readme.md · README · 95 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <h1 align="center">Marionette.js</h1>
- <p align="center">
- <img title="Marionette" alt="Marionette logo" src="https://github.com/marionettejs/marionette/raw/master/marionette-mark.svg" width="140" height="145" />
- </p>
- <p align="center">Built for agent-led development.</p>
- <p align="center">
- <a href="https://github.com/marionettejs/marionette/actions/workflows/ci.yml"><img src="https://github.com/marionettejs/marionette/actions/workflows/ci.yml/badge.svg?branch=master" alt="CI status" /></a>
- <a href="https://www.npmjs.com/package/marionette"><img src="https://img.shields.io/npm/v/marionette.svg" alt="npm version" /></a>
- </p>
- Marionette v5 is a JavaScript library built for agent-led development. It gives
- coding agents a consistent structure for building interfaces, version-matched
- contracts to work from, and tools to check the code they produce.
- The v5 npm package is **`marionette`**; **`backbone.marionette`** is the legacy
- package. Check the installed package name and version before choosing documentation.
- V5 core has native DOM support and requires neither Backbone nor jQuery. Backbone
- Models and Collections integrate through optional adapters, so an existing Backbone
- application can keep its Models and persistence. For v4 upgrades, use the
- [migration guide](docs/guides/migration.md).
- ## Why Marionette for agent-led development?
- - **Clear places for behavior.** Views render content and handle local interactions.
- Regions own View replacement and destruction. Applications coordinate feature
- readiness and lifetime. These boundaries give an agent a repeatable way to
- compose features and make changes without inventing their ownership from scratch.
- - **The relevant contract in context.** Documentation and an agent skill ship with
- the package. API and diagnostic lookup lead to specific contracts; documentation
- MCP access connects those references to supported agent clients.
- - **Feedback on generated code.** TypeScript declarations, an ESLint rule against
- private framework access, and stable diagnostic codes help agents catch mistakes.
- Runnable examples and public behavior checks show how to verify interaction, cancellation, replacement, and cleanup.
- Start with the [agent entrypoint](docs/agents.md).
- [Consumer tooling](docs/tooling.md) covers skill/plugin installation, documentation
- MCP access, lint, types, and installed documentation lookup.
- ## Try v5
- Packaged applications support Node 22.22.2+ (22.x), 24.15.0+ (24.x) and 26.x, with required installed-package verification at each floor and latest patch. Use the latest patch of a supported LTS line. Optional companions have their own requirements; `@mnjs/router` requires Node 24.15.0 or newer. For framework development or Git installs, select the pinned [source toolchain](https://github.com/marionettejs/marionette/blob/master/CONTRIBUTING.md#set-up-the-repository).
- Install matching core package versions in your browser application. The renderer is independently versioned; follow the matching [quick start](docs/quick-start.md):
- ```sh
- npm install --ignore-scripts --save-exact marionette@5.1.1 @mnjs/utils@5.1.1 @mnjs/radio@5.1.1 @mnjs/html@1.0.0
- ```
- Given `<div id="app"></div>` in your page, this module shows a dismissible panel:
- ```js
- import { Region, View, setDomApi } from 'marionette';
- import HtmlDomApi from '@mnjs/html/marionette';
- import { html } from '@mnjs/html';
- setDomApi(HtmlDomApi);
- const Notice = View.extend({
- template: () => html`
- <p>Your report is ready.</p>
- <button type="button">Dismiss</button>`,
- triggers: { 'click button': 'dismiss' }
- });
- const region = new Region({ el: '#app' });
- const notice = new Notice();
- region.listenTo(notice, 'dismiss', () => region.empty());
- region.show(notice);
- ```
- The View turns a click into intent. The Region renders and mounts the View;
- `empty()` destroys it and releases its event connections. Showing another View in
- that Region also destroys the previous one. No separate DOM removal or event
- unbinding is needed.
- The [quick start](docs/quick-start.md) supplies the complete HTML and Vite setup.
- Continue with the [composition starter](docs/guides/composition.md) for a compact list/detail feature with coordinated readiness, then the [Records lesson](docs/records.md) for loading, retry and error UI. Upgrading an existing application? Use the
- [v4-to-v5 migration guide](docs/guides/migration.md).
- ## Documentation
- Start with the [v5 documentation index](docs/readme.md), [quick start](docs/quick-start.md), or [API index](docs/api.md). The reference is organized by class and shared contracts; runnable lessons demonstrate selected workflows.
- The [testing guide](docs/guides/testing.md) supplies a runnable recipe for checking
- interaction, replacement, readiness, and teardown.
- ## Development
- Found an awkward API, a missing example, or a bug that survives a convincing test
- suite? Bring a small reproduction. Contributions should start from a focused public
- issue that describes the intended behavior and its runtime cost. See
- [CONTRIBUTING.md](https://github.com/marionettejs/marionette/blob/master/CONTRIBUTING.md)
- ## License
- Marionette is available under the [MIT license](license.txt).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.