agnosticui
AgnosticUI Local (v2) is a CLI-based UI component library that copies components directly into your project. Works with AI tools, agent-driven UIs, and prompt-ready workflows.
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/AgnosticUI/agnosticui 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/AgnosticUI/agnosticui'
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/agnosticui--agnosticui)HTML
<a href="/listings/agnosticui--agnosticui"><img src="/api/listings/agnosticui--agnosticui/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
**React**
cd my-react-app npx agnosticui-cli init --framework react npx agnosticui-cli add Button Card Input
**Vue**
cd my-vue-app npx agnosticui-cli init --framework vue npx agnosticui-cli add Button Card Input
**Svelte**
cd my-svelte-app npx agnosticui-cli init --framework svelte npx agnosticui-cli add Button Card Input
**Lit / Web Components directly**
cd my-lit-app npx agnosticui-cli init --framework lit npx agnosticui-cli add Button Card Input
After running `add`, your terminal prints the exact import path for your project. No guessing. **Supports agent-driven and prompt-ready UI workflows.**
---
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.
README.md · README · 269 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.
- <p align="center">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="./v2/graphics/hero-dark.svg">
- <img src="./v2/graphics/hero-light.svg" alt="AgnosticUI" width="610" />
- </picture>
- </p>
- <p align="center"><b>Copy the source</b> · <b>Own the code</b> · <b>Framework-agnostic</b> · Built for <b>humans and AI agents</b></p>
- <p align="center">
- <strong>One component library. Every framework.</strong>
- </p>
- <p align="center">
- <a href="https://agnosticui.com">Documentation</a> ·
- <a href="https://www.agnosticui.com/playbooks/login.html">Login AI Playbook</a> ·
- <a href="https://www.agnosticui.com/playbooks/onboarding.html">Onboarding AI Playbook</a> ·
- <a href="https://www.agnosticui.com/playbooks/dashboard.html">Dashboard AI Playbook</a> ·
- <a href="https://www.agnosticui.com/components/button.html">Components</a> ·
- <a href="https://www.agnosticui.com/installation.html">Quick Start</a>
- </p>
- <br />
- ---
- ## Source-first architecture
- AgnosticUI components are copied into your project at install time.
- They live in your repo (not hidden inside `node_modules`):
- - Full control over the source
- - Native integration with your framework
- - AI-readable, high-fidelity context
- ---
- ## You own the source (and the Context)
- ```bash
- cd your-project
- npx agnosticui-cli init --framework vue # or react, lit, svelte
- npx agnosticui-cli add Button Card Input
- ```
- The component source lands **directly in your project**. Readable, editable, and yours.
- ```shell
- src/
- components/
- ag/
- Button/
- Button.vue ← your file now
- Button.css ← your tokens now
- Button.test.ts ← your tests now
- ```
- Components land under `src/components/ag/` by default: a dedicated namespace that keeps AgnosticUI components separate from your own. Configurable if you prefer otherwise.
- ### 🤖 AI-Native by Design
- Because the code is local, it solves the "Black Box" problem of traditional libraries hidden in `node_modules`.
- **Cursor · Claude · Copilot · Windsurf · Aider · Gemini · Replit · Kiro · Antigravity**
- Every tool sees the **raw source**. This creates a high-fidelity environment for **Generative UI** and **Agent-driven interfaces**:
- - **Reduce Hallucination:** No more "invented" props or APIs. Since the LLM reads local files like any other code, it knows exactly what is possible.
- - **Better Token Efficiency:** Using semantic HTML and standard CSS provides "clean context." Agents spend fewer tokens to understand the UI, leading to faster, more accurate generations.
- - **Agent Skills:** Treat [AgnosticUI Playbooks](https://www.agnosticui.com/playbooks/login.html) as pre-defined skills. Use them to prompt an agent to scaffold complex, accessible workflows (Login, Onboarding, Discovery Dashboard, Support Center, Data Grids) using the local components it already "sees."
- This is the architecture for the next era of development: **context-aware, framework-agnostic, and AI-ready.**
- The **A2UI v1.0** generative UI layer ships with three companion resources:
- - [`v2/a2ui/README.md`](./v2/a2ui/README.md) — full architecture, AST codegen pipeline, multi-framework renderers (`@agnosticui/a2ui-lit`, `@agnosticui/a2ui-react`, `@agnosticui/a2ui-vue`), and Support Center demos
- - [`v2/a2ui/catalog/SKILL.md`](./v2/a2ui/catalog/SKILL.md) — agent skill instructions and prompt rules for streaming valid A2UI `v1.0` surfaces
- - [`v2/a2ui/catalog/agnosticui-catalog.json`](./v2/a2ui/catalog/agnosticui-catalog.json) — 25-component A2UI `v1.0` JSON Schema catalog (`https://agnosticui.com/a2ui/v1/catalog.json`)
- ---
- ## Built once. Runs everywhere.
- AgnosticUI's components are authored as **Lit Web Components**, a standards-based layer over native Custom Elements. The CLI wraps them for your framework at copy time.
- <p align="center">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="./v2/graphics/architecture-dark.svg">
- <img src="./v2/graphics/architecture-light.svg" alt="AgnosticUI Architecture: AI Playbooks direct the Lit Core, which the CLI ejects into React, Vue, and Svelte" width="860" />
- </picture>
- </p>
- Your design system doesn't fork when your tech stack does. Supports **agent-generated UI workflows directly from Playbooks**.
- ...
- | | AgnosticUI | Typical component library |
- | ------------------------------------ | ----------------- | ------------------------- |
- | Source in your repo | ✅ | ❌ |
- | Framework agnostic core | ✅ | ❌ |
- | LLM-readable locally | ✅ | ❌ |
- | AI & agent-driven Playbooks included | ✅ | ❌ |
- | Multiple theme skins | ✅ | Limited |
- | Zero runtime dependency | ✅ after ejection | ❌ |
- ---
- ## AI Playbooks: AI-Prompt-Driven UI Components
- Playbooks (Login Form, Onboarding Wizard, Discovery Dashboard, Support Center, Data Grid, Blog / Article Reader, Landing / Marketing Page) demonstrate **modular, prompt-driven UI components**. Each Playbook can be used in **agent systems**, for **context-aware applications**, or to create **generative UI patterns**.
- | Playbook | What it builds |
- | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
- | [Login Form](https://agnosticui.com/playbooks/login.html) | Responsive login: mobile, floating card, two-column desktop; works with AI prompt-driven generation |
- | [Onboarding Wizard](https://agnosticui.com/playbooks/onboarding.html) | Multi-step flow with progress, validation, and skip logic; supports agent-assisted workflows |
- | [Discovery Dashboard](https://agnosticui.com/playbooks/dashboard.html) | Dashboard shell with header, sidebar, and data regions — ideal for agent-generated interfaces |
- | [Support Center](https://agnosticui.com/playbooks/support.html) | Help center with search, categories, and article layout; integrates with prompt-driven workflows |
- | [Data Grid](https://www.agnosticui.com/playbooks/grid.html) | Responsive, interactive data grid with sorting, filtering, and multiple view modes; compatible with agent-driven and context-aware interfaces |
- | [Blog / Article Reader](https://www.agnosticui.com/playbooks/blog.html) | Typography-first editorial layout with scroll-aware components and in-article search highlighting; theme switcher, dark/light mode, React/Vue/Lit demos |
- | [Landing / Marketing Page](https://www.agnosticui.com/playbooks/landing.html) | Polished product marketing page with hero, features, testimonials, pricing, and FAQ; animated components, theme switcher, dark/light mode, React/Vue/Lit demos |
- Each Playbook on the docs site includes live StackBlitz examples for React, Vue, and Lit, and ships with:
- - **`PROMPT-3-FRAMEWORKS.md`**: one prompt to generate the pattern across all three frameworks
- - **Skin switcher** to preview your theme tokens instantly
- **Fully prompt-ready for agent-driven UI generation**. Drop a Playbook prompt into Cursor, Claude Code, or Copilot and watch it assemble `Input`, `Button`, `Card`, and `FormGroup` correctly on the first try — because it has the full recipe, not just a component reference.
- The prompts are yours to adapt. Feed one to your LLM as a crash course in AgnosticUI's patterns, fork it for your own stack, or use it as a blueprint for writing Playbooks around your own UI patterns.
- ---
- ## Theme skins via CSS custom properties
- AgnosticUI components expose their entire visual surface through CSS custom properties. Swap a skin and every component updates; no code changes, no find-and-replace.
- ```css
- /* Base tokens are required, then layer your skin on top */
- @import "./components/ag/styles/ag-tokens.css";
- @import "./components/ag/styles/ag-tokens-dark.css";
- @import "./components/ag/styles/brutalist-light.css";
- @import "./components/ag/styles/brutalist-dark.css";
- ```
- Hand it to a designer. Get back a token file. Import it. Done.
- ---
- ## Quick Start
- **React**
- ```bash
- cd my-react-app
- npx agnosticui-cli init --framework react
- npx agnosticui-cli add Button Card Input
- ```
- **Vue**
- ```bash
- cd my-vue-app
- npx agnosticui-cli init --framework vue
- npx agnosticui-cli add Button Card Input
- ```
- **Svelte**
- ```bash
- cd my-svelte-app
- npx agnosticui-cli init --framework svelte
- npx agnosticui-cli add Button Card Input
- ```
- **Lit / Web Components directly**
- ```bash
- cd my-lit-app
- npx agnosticui-cli init --framework lit
- npx agnosticui-cli add Button Card Input
- ```
- After running `add`, your terminal prints the exact import path for your project. No guessing. **Supports agent-driven and prompt-ready UI workflows.**
- _💡 AgnosticUI utilizes a custom-built CLI engine that dynamically wraps standards-based Lit Web Components into tailored framework syntax at copy time._
- ---
- ## Accessibility first, not last
- - Semantic HTML
- - WAI-ARIA patterns validated
- - Keyboard navigation across all interactive components
- - AA-validated color contrast
- - Reduced motion support
- - Focus management built in
- ---
- ## 55 components. Production-ready.
- ### Core UI
- `Accordion` · `Alerts` · `AspectRatio` · `Avatar` · `Badge` · `Breadcrumb` · `Button` · `Card` · `Checkbox` · `Collapsible` · `Combobox` · `CopyButton` · `Dialog` · `Divider` · `Drawer` · `EmptyState`
- ### Forms & Inputs
- `Fieldset` · `Input` · `Radio` · `Rating` · `Select` · `SelectionButtonGroup` · `SelectionCardGroup` · `Slider` · `Toggle`
- ### Navigation & Layout
- `Header` · `Menu` · `Pagination` · `Tabs`
- ### Feedback & Status
- `Loader` · `Progress` · `ProgressRing` · `ScrollProgress` · `Skeleton Loader` · `Spinner` · `Toast`
- ### Content & Display
- `Icon` · `Icon Button` · `Image` · `IntlFormatter` · `Kbd` · `Link` · `Mark` · `MessageBubble` · `Popover` · `ScrollToButton` · `Table` · `Tag` · `Timeline` · `Tooltip` · `VisuallyHidden`
- ### Lab (experimental)
- `BadgeFx` · `ButtonFx` · `Flex` · `IconButtonFx`
- ---
- ## Contributing
- AgnosticUI is open source and welcomes contributions. See [CONTRIBUTING.md](./CONTRIBUTING.md) for component authoring guidelines, the token system, and how to write Playbook entries.
- ---
- ## License
- Apache License 2.0 © [AgnosticUI](https://github.com/AgnosticUI/agnosticui/blob/master/LICENSE)
- ## Where is v1?
- AgnosticUI v2 is a complete rewrite and is not compatible with v1. If you need v1, it remains available via git tags:
- - Packages: `agnostic-angular`, `agnostic-react`, `agnostic-vue`, `agnostic-svelte`, etc.
- - Tag: `v1-legacy`
- ---
- <details>
- <summary><b>Experimental: Model Context Protocol (MCP) Server Preview</b></summary>
- An experimental MCP server has been merged into `master` (located in `v2/mcp-server/`), exposing four native tools directly to AI agents like Claude Code or Cursor:
- - **`get_component_schema`**: Returns precise slots, observed attributes, and framework wrapper imports directly from the `custom-elements.json` manifest to eliminate prop hallucinations.
- - **`generate_streamed_layout`**: Conducts pre-flight layout evaluations via a Draft-07 AJV engine to catch schema property violations and dead topological child references before code is written.
- - **`get_design_tokens`**: Resolves compiled Style Dictionary token categories directly to their functional `--ag-<prop>` naming parameters to guarantee theme variable accuracy.
- - **`resolve_skin_properties`**: Parses localized sub-theme style sheets to supply target override property dictionaries for specific visual art directions.
- Full package indexing and release tracking are underway.
- </details>
- <details>
- <summary><b>Maintainer Contact</b></summary>
- AgnosticUI is architected and maintained by Rob Levin. If you're looking for a veteran frontend architect that specializes in design systems, custom CLI tooling, and agent-driven UIs, let's build something together.
- - **Inquiries & Consulting:** Connect with [Rob Levin on LinkedIn](https://www.linkedin.com/in/robinlevin/) to discuss architecture assessments, token migrations, or custom agent-facing UI implementations.
- </details>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.