NoaCG Broadcast Graphics and Playout

@noacg/cli

The NoaCG CLI - the agent door into NoaCG Studio. Make broadcast graphics for NoaCG from a coding agent, or from your own terminal: scaffold, validate, inspect, screenshot, package, save - against any NoaCG deployment. The full account is the repo's docs/AGENT_CLI.md.

The package is `@noacg/cli`; the command it installs is `noacg`. So npm i -g @noacg/cli gives you noacg validate …, and every command below is spelled the way you will type it.

One tool, three entrances. The MCP server is not a second thing to choose between. noacg mcp runs this same package as an MCP server, and the Claude Code / Codex plugin carries the noacg-graphic skill, which drives this same package from the terminal. Pick the entrance your agent uses -

Whichever you pick, the noacg-graphic skill is the same text: what a NoaCG graphic must expose, and the loop to get there. It is the contract, not design guidance.

Connecting NoaCG Playout to a CasparCG server is a different tool, NoaCG Bridge, downloaded from noacg.studio/downloads (the newest Bridge release on the repository's Releases page). It is not about authoring, has its own version number, and needs nothing from this package.

Paste this to your agent

The short way in: one prompt that runs this CLI through npx in the session you have open, with nothing installed first. The agent checks its setup, connects your NoaCG account in the browser if needed, asks what to make, and saves each finished graphic to your library with its link. Copy it from noacg.studio/downloads; it names the exact CLI version to run.

The commands it runs are below, for anyone who would rather run them by hand.

Install

npx @noacg/cli doctor                 # no install: runs the published build

npm i -g @noacg/cli # or install it once

Claude Code: the noacg plugin ships the skill as /noacg:graphic, with nothing to install first; the skill runs this CLI from the terminal. The optional noacg-mcp plugin adds the always-on MCP server (cli/plugin-mcp/README.md says what it costs). In a Claude Code session (2.1.275 or later), one command adds the marketplace, asks you to confirm it, and installs:

/plugin install noacg --marketplace NoaCG/NoaCG-Studio

From a terminal or a setup script, the same install is two commands:

claude plugin marketplace add NoaCG/NoaCG-Studio

claude plugin install noacg@noacg-studio

For the MCP server on its own: claude mcp add noacg -- npx -y @noacg/cli mcp.

A plugin installed from this marketplace does not update itself until you say so. Claude Code turns auto-update on only for Anthropic's own marketplaces, so the skill text stays the version you installed. Turn it on once in /plugin, Marketplaces, noacg-studio, Enable auto-update, and new versions arrive at the start of a session. Or update by hand: claude plugin marketplace update noacg-studio && claude plugin update noacg@noacg-studio. noacg doctor names the installed version whenever it is behind the CLI you are running.

Codex: the same plugin, from the same repository. codex plugin add installs the skill, so there is nothing to copy by hand; codex plugin add noacg-mcp@noacg-studio adds the optional always-on server the same way.

codex plugin marketplace add NoaCG/NoaCG-Studio

codex plugin add noacg@noacg-studio

The same goes for Codex, in its own spelling: codex plugin marketplace upgrade noacg-studio && codex plugin add noacg@noacg-studio.

On a Codex without codex plugin, do it the long way instead: copy skill/noacg-graphic/ from this package to ~/.codex/skills/noacg-graphic/, then codex mcp add noacg -- npx -y @noacg/cli mcp.

Any MCP client: run npx -y @noacg/cli mcp as a stdio server - command npx, args -y @noacg/cli mcp.

Use

npx @noacg/cli types

npx @noacg/cli scaffold --type scoreboard --design neutral --name "Football scoreboard" --out ./football-scoreboard

...design it: edit football_scoreboard.html, css/template.css, js/template.js ...

(the html is named after the GRAPHIC, not the folder: the name's spaces become underscores)

npx @noacg/cli validate ./football-scoreboard --screenshots ./shots npx @noacg/cli inspect ./football-scoreboard npx @noacg/cli login # once per machine: a scoped key that can only create graphics in your library npx @noacg/cli save ./football-scoreboard

Add --json to any command for one JSON object on stdout. Exit codes: 0 clean, 1 findings or refused, 2 usage/IO error. Environment: NOACG_URL (default https://noacg.studio; a dev server or self-host works), NOACG_BROWSER (a Chromium executable; otherwise the system Chrome/Edge or a Playwright-installed Chromium is used), NOACG_AGENT_KEY (a key for CI - beats the stored one), NOACG_CREDENTIALS_DIR (the folder login keeps its key in, for more than one login on one account; default the per-user config directory).

The package on disk

<slug>/

SOURCES - edit these GENERATED - never edit; noacg validate rebuilds them .html .ograf.json the OGraf v1 manifest (+ v_noacg) css/template.css graphic.mjs the OGraf Web Component js/template.js FIELDS.md README.md controlpanel.html js/gsap.min.js images/ fonts/

One folder is a valid EBU OGraf v1 Graphic, the SPX/CasparCG package and the workspace you edit. Zip it and it imports through the studio's Import door; drop it in an OGraf renderer and it plays. Those two are what the folder satisfies IN PLACE; the graphic itself is plain HTML, CSS and JS, and NoaCG exports it to an OBS/vMix overlay, H2R or LiveOS from the same sources. In through NoaCG, out to anything.

MCP

The same verbs, spoken over stdio - npx -y @noacg/cli mcp. One tool, noacg, with the terminal's grammar: command is the verb (types, scaffold, validate, inspect, screenshot, docs, save - the last after noacg login) and the other arguments are that verb's flags, so { "command": "validate", "path": "./my-graphic", "screenshots": true } returns the frames as images. The skill's references are also resources (noacg://docs/ ). The noacg-graphic skill ships under skill/.

One tool rather than seven because an MCP client puts every tool's schema into the model's context in every session where the server is configured, whether or not that session is about graphics. This shape is about 590 tokens against about 1,160 for the seven-tool one it replaced. The teaching is in the skill, which loads only when a graphic is being made.

bridge and caspar are deliberately not MCP tools: they drive live playout hardware, which is an operator's decision rather than an authoring agent's.

Develop

npm install

npm run build # generates the plugin's skill copy, then tsc NOACG_URL=http://localhost:5174 npm test # against a NoaCG dev server's /bridge npm run check:skill # every shipped copy of the skill matches cli/skill/

Licence

Apache-2.0 - deliberately different from NoaCG Studio itself, which is AGPL-3.0-only. This tool is the door into NoaCG for coding agents, so it is licensed to be installed anywhere without a policy review: a permissive licence, an explicit patent grant, no copyleft reaching anything you build with it. The AGPL on the studio protects the hosted application; it was never meant to gate the client that talks to it.

Graphics you create are yours. Nothing in either licence attaches to the templates this tool scaffolds or to what you export and put on air.

One third-party note, since a scaffolded package carries it: the animation runtime bundled into a graphic (`js/gsap.min.