Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
What This Skill Does
Supernal Interface is a TypeScript framework that makes existing application functions callable by AI assistants via decorators. Decorate a function with @Tool and any connected AI chat adapter can discover and invoke it with type safety. Supports CopilotKit out of the box and allows custom chat UI adapters.
Decorator-based registration means you don't maintain a separate tool manifest — the function definition and its AI metadata stay in one place.
When to use it
- Adding AI control to an existing TypeScript app without rewriting logic
- Exposing CRUD operations to a chat assistant in a React app
- Wiring up CopilotKit to auto-discover all decorated tools
- Persisting AI-accessible state across user sessions with React hooks
- Generating Gherkin-based tests from decorated tool definitions
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: 'Make my TodoApp controllable by an AI chat assistant'
- 1Install @supernal/interface and import Tool decorator
- 2Annotate addTodo and completeTodo methods with @Tool, providing name and description
- 3Create a CopilotKit adapter with autoRegisterTools: true
- 4Wrap the React app in ChatUIProvider with the adapter
- 5Verify AI assistant can discover and call the decorated methods
The chat UI can now call addTodo and completeTodo directly, with full type safety and auto-discovered tool schemas
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.