AI agents

Use Sona UI with coding agents that can inspect a project, select a suitable component, and install its source through the registry. The agent should adapt the component to the project rather than treating it as an isolated snippet.

How it works

Layer	What it does
`Registry`	Delivers source files, dependencies, and foundations through the Sona namespace.
`Agent catalog`	Helps an agent select a component by intent, capability, accessibility, and motion.
`Sona UI skill`	Teaches the agent how to inspect, install, compose, and validate components.
`MCP`	Gives supported clients natural-language access to the shadcn registry.

Recommended workflow

Connect the registry to the project where the agent will work.
Install the Sona UI skill.
Describe the interaction you need, not just a component name.
Review the agent's selection and explanation.
Install the component and validate the consumer project.

Configure the registry

Add the Sona UI registry to the components configuration file.

json

components.json

{
"registries": {
  "@sona-ui": {
    "url": "https://sonaui.com/r/{name}.json"
  }
}
}

Connect MCP

The official shadcn MCP server is the supported path for natural-language registry discovery and installation. Sona UI does not require a custom MCP server.

toml

~/.codex/config.toml

[mcp_servers.shadcn]
command = "npx"
args = ["shadcn@latest", "mcp"]

Ask for a component

Use a request that states the interaction, expected behavior, and any constraints.

text

Find an accessible tab component for switching between related settings. Do not install anything yet.

text

Inspect @sona-ui/animated-dialog, explain its accessibility and motion behavior, then install it without changing the existing page layout.

Verify the connection

Ask the agent to list the components available from the Sona UI registry and recommend the best choice for switching between related settings. It should explain the choice and link to the relevant documentation or registry item before it installs anything.

Troubleshooting

If the registry is unavailable, confirm the components configuration, item URL placeholder, client configuration, and network access. When installation fails, first identify whether the issue belongs to consumer configuration, the registry payload, agent resources, or deployment.

Resources

Contact

Found a bug or need help using Sona UI with an agent? Open an issue on GitHub.

License & Usage

Sona UI is available under the MIT license. You may use, modify, and distribute components in personal and commercial projects.