three ways in
Get started
Pick the path that sounds like you. Each one ends with a page that works.
-
I'm working with an AI agent
No terminal needed: paste this into Claude, ChatGPT, Cursor or any agent that can read a web page, and change the words in brackets.
Make me a one-page website for [my homestay in Aldona] using Susegad UI. First read https://susegad.asymmetrica.ai/llms.txt and follow its "Start here" section. Use the warm look and a drawn scene that fits the place, and keep it easy to use on a phone. Ask me for anything you need. When it is ready, explain in plain words how I can put it online.
If your agent can run commands on your computer, you can give it more to work with:
Give your agent the library's
SKILL.mdand say what you want, the way you would say it to a person. The skill teaches it the three looks, how to install each piece and how the scenes work. The MCP server lets it search the shelf, read a piece's prompt and add pieces itself.npx @susegad/cli skill --harness claude --globalTo add the MCP server to Claude Code:
claude mcp add --transport stdio susegad -- npx -y @susegad/mcpIt needs Node 22 or later. Run it from the project it should add pieces to.
-
I'm building a site
One command makes a whole site from a template: an event page in English and in Konkani, with the pieces it uses copied in beside it. Change every word; the files are yours.
npx @susegad/cli create my-sitecreatearrives on npm with version 0.2.0. Until then, run it from a clone, as the handoff shows. -
I'm adding pieces to a project
Copy just the pieces you want into your own code with
add, and everything they stand on comes too. Already using shadcn? The same pieces are served for it at/r/.npx @susegad/cli add scene-paus badgenpx shadcn@latest add https://susegad.asymmetrica.ai/r/button.jsonFollow a first page, step by step The shadcn index, /r/registry.json
A first page, step by step
A homestay in Aldona: one page with a drawing, a badge and a footer. Do it by hand, with the CLI, or with an agent; each way arrives at the same page.
One file, index.html, in a folder with nothing else in it. When you are done, opening it shows the Paus drawing (rain on a window, drawn live), a small card of status, and a footer that says who made the page.
Way 1: by hand
Make an index.html and paste these lines into it:
<!doctype html>
<html lang="en" data-register="warm">
<head>
<meta charset="utf-8">
<title>A homestay in Aldona</title>
<link rel="stylesheet" href="https://susegad.asymmetrica.ai/packages/tokens/fonts.css">
<link rel="stylesheet" href="https://susegad.asymmetrica.ai/packages/tokens/tokens.css">
</head>
<body>
<sg-scene name="paus" register="warm">
<h2>Monsoon at the window</h2>
<p>The river runs high, the veranda smells of wet earth.</p>
</sg-scene>
<p><sg-badge tone="info" busy>Two rooms free for December</sg-badge></p>
<footer>
<p>Made with Susegad UI, in Aldona.</p>
</footer>
<script type="module">
import "https://susegad.asymmetrica.ai/packages/core/index.js";
import "https://susegad.asymmetrica.ai/packages/scenes/paus/index.js";
import "https://susegad.asymmetrica.ai/packages/components/badge/badge.js";
</script>
</body>
</html>
Save, open the file in a browser, and the rain falls. The data-register on <html> sets the mood for the whole page; change warm to quiet and the drawing stills into a frame.
Way 2: with the CLI
The command line copies the pieces into your project, where they become your code. Change anything you like afterwards.
npx @susegad/cli add scene-paus badge --dir src/lib
Your folder now holds src/lib/susegad/ with the scene, the badge and everything they stand on. The same page then reads:
<script type="module">
import "./src/lib/susegad/core/index.js";
import "./src/lib/susegad/scenes/paus/index.js";
import "./src/lib/susegad/components/badge/badge.js";
</script>
susegad list shows everything on the shelf, and susegad info scene-paus explains one piece before you take it.
Way 3: with an agent
Give your coding agent the library's SKILL.md from the top of the repository and say what you want, the way you would say it to a person. The skill carries the register, the install lines and the scene contract, so the agent lands on the same page this walkthrough does. A prompt that works:
Build me a single page for a homestay in Aldona. Use Susegad UI: the paus scene over the top, a badge for room availability, and a quiet footer. The register is warm.
The susegad skill command installs that skill into your agent's folder for you: npx @susegad/cli skill --harness claude --global. The MCP server lets your agent search the shelf and add pieces itself; its page says how to set it up.
What you should see
A page where rain runs down a window and your words sit calm inside it. A badge that says what is still happening. A footer with your name on it. From there: every piece has its own page on this site, with its prompt, its demo and its install line. Start with Scenes, or look the techniques up in the pencil box.