supernal-interface
by ianderrington
Coding Agents & IDEsBrief
Universal AI Interface framework for making applications AI-controllable.
Description
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
User asks: 'Make my TodoApp controllable by an AI chat assistant'
- 1
Install @supernal/interface and import Tool decorator
- 2
Annotate addTodo and completeTodo methods with @Tool, providing name and description
- 3
Create a CopilotKit adapter with autoRegisterTools: true
- 4
Wrap the React app in ChatUIProvider with the adapter
- 5
Verify 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
- supernal.ai/enterprise account for enterprise features (auto test generation, multi-model routing, audit logging)
Installation
clawhub install ianderrington/supernal-interfaceRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.