A comprehensive developer tool for automated contract scanning, test generation, and seamless AI agent integration via MCP.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install si
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install si using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is si (Supernal Interface CLI)?
The Supernal Interface CLI (si) is a high-performance developer tool designed to bridge the gap between application architecture and automated quality assurance. As a key component of Openclaw Skills, it enables developers to maintain strict architectural integrity by scanning Next.js routes and components to generate type-safe contracts. This ensures that application navigation and component identifiers remain consistent across the codebase.
Beyond simple scanning, the tool empowers teams to adopt contract-first and story-driven development workflows. It synthesizes technical metadata into actionable tests and integrates directly with AI-powered development environments. By automating the configuration of the Model Context Protocol (MCP), it allows AI agents to understand and interact with your project structure with zero manual setup, making it an essential utility for modern web and mobile engineering.
si (Supernal Interface CLI) Use Cases
- Scanning Next.js and SwiftUI projects to automatically generate route and component name contracts.
- Generating Jest or Playwright test suites directly from @Tool decorators and Gherkin feature files.
- Automating the setup of MCP servers and Claude Code integration for AI-assisted development.
- Validating application graphs to identify broken navigation links or orphaned routes before deployment.
- Recording and validating BDD-style story tests to ensure visual and functional requirements are met.
How si (Supernal Interface CLI) Works
- Initialize the CLI within your project to configure the environment and detect the framework (e.g., Next.js or iOS).
- Execute scanning commands to extract routes, accessibility identifiers, and data-testids into centralized contract files.
- Validate code decorators and structural contracts to ensure they align with the current application state.
- Generate automated unit and E2E tests based on the scanned contracts or provided Gherkin story files.
- Run comprehensive test suites including visual regression, accessibility (a11y), and performance benchmarks.
- Configure the Model Context Protocol to expose project logic and tools to AI agents for enhanced coding assistance.
si (Supernal Interface CLI) Setup
Install the Supernal Interface CLI globally using npm:
npm install -g @supernal/interface
Initialize your project to begin using Openclaw Skills features:
si init
si scan-routes
si setup-mcp
si (Supernal Interface CLI) Data Schema & Taxonomy
The CLI manages project metadata through structured TypeScript contracts and organized test directories.
| Data Category | Default Location | Description |
|---|---|---|
| Route Contracts | ./src/routes/Routes.ts |
Type-safe mapping of application routes and parameters. |
| Name Contracts | ./src/names/Components.ts |
Registry of component identifiers and test IDs. |
| Test Output | ./tests/generated/ |
Automatically generated Jest and Playwright test files. |
| Story Definitions | *.feature / *.story.ts |
BDD scenarios and their corresponding implementations. |
si (Supernal Interface CLI) Advanced Features
- Support for multi-platform scanning including Next.js, React Router, and SwiftUI views.
- Automated data-testid injection for legacy components to simplify testing setup.
- Visual regression testing with screenshot capture and comparison capabilities.
- Automated MCP server creation for zero-config integration with AI coding assistants.
- Graph-based validation to detect broken links and orphaned application nodes.
- High-performance caching for @Tool decorators to accelerate test generation workflows.
SKILL.md
Loading
Related Openclaw Skills
Supernal Coding CLI (sc)
A comprehensive CLI for automating developer workflows, task management, and autonomous agent execution.
ClawX Agent Verification
A comprehensive verification and identity management system for AI agents via the ClawX OAuth framework.
Apple Notes Skill
A comprehensive automation utility for programmatically extracting, monitoring, and exporting Apple Notes content into structured formats.
Knowledge
A unified system for capturing, organizing, and retrieving URLs, research, and media extracts through a file-based structure.
Supernal Interface
A universal framework that uses TypeScript decorators to make application functions natively controllable by AI agents with full type safety.
Universal Command
A unified framework to define command logic once and automatically deploy it across CLI, Next.js APIs, and Model Context Protocol (MCP) tools.
Featured*
