# SuperCmdK

> One typed action system for React interfaces, WebMCP agents, voice, and automation.

## About

This website is the live demonstration and documentation entry point for SuperCmdK. It shows a command palette for people, route-scoped commands, an on-device tool-calling agent, shared confirmation policy, and browser-agent access to the same tool registry.

Intended audience: React and TypeScript developers who want one typed action system shared by human interfaces, WebMCP browser agents, embedded agents, voice clients, accessibility controls, and automation.

Website: [https://nicholaszolton.github.io/SuperCmdK/](https://nicholaszolton.github.io/SuperCmdK/)

## Publisher

[Nicholas Zolton](https://github.com/NicholasZolton/SuperCmdK)

SuperCmdK is an independent open-source project, not a hosted SaaS company. The software is MIT-licensed and the demo does not require an account or make purchases.

## Agent access

This website exposes its current page tools through WebMCP at `document.modelContext`.

Open the live demo at https://nicholaszolton.github.io/SuperCmdK/ in a WebMCP-capable browser to discover its current page tools. SuperCmdK publishes WebMCP tools directly from the page; it does not operate a separate remote MCP server. The tools operate only on simulated local demo state and use SuperCmdK's shared validation, authorization, confirmation, and cancellation path.

## What the page demonstrates

- A Cmd+K command palette for human users.
- Commands that mount and unmount with the current page scope.
- A WebMCP registry that follows the same scoped lifecycle.
- A local Cactus Needle model that can chain JavaScript tool calls in a Worker.
- Confirmation before a consequential simulated production deletion.
- A visible activity log showing state-changing tool outcomes.

## Packages and source

- [@supercmdk/react on npm](https://www.npmjs.com/package/@supercmdk/react) — React UI, core tool registry, and built-in WebMCP bridge.
- [@supercmdk/needle on npm](https://www.npmjs.com/package/@supercmdk/needle) — Optional pinned model and WASM runtime.
- [Source repository](https://github.com/NicholasZolton/SuperCmdK)
- [Changelog](https://github.com/NicholasZolton/SuperCmdK/blob/main/CHANGELOG.md)

## Tools

### `find_project` — Find project

Find a project by its human-readable name and return its ID, name, and status. Use this before another tool needs a project ID.

- Access: read-only
- Arguments:
  - `name` (string, required) — Project name from the user's request

### `create_task` — Create task

Create a task in a project and return its ID, project ID, title, and creation status. Requires the exact project ID returned by find_project.

- Access: may modify state
- Arguments:
  - `projectId` (string, required) — Exact project ID returned by find_project
  - `title` (string, required) — Concise task title requested by the user

### `delete_production_deployment` — Delete production deployment

Delete the simulated production deployment and return its deletion status and environment. Use only when the user explicitly asks to delete production.

- Access: may modify state; consequential; confirm before execution
- Arguments: none

## Documentation

- [Complete README and quickstart](https://github.com/NicholasZolton/SuperCmdK#readme)
- [Installation](https://github.com/NicholasZolton/SuperCmdK#install)
- [Tool registry and schemas](https://github.com/NicholasZolton/SuperCmdK#tools)
- [WebMCP integration](https://github.com/NicholasZolton/SuperCmdK#webmcp)
- [Policies and confirmation](https://github.com/NicholasZolton/SuperCmdK#policies-and-confirmation)
- [Embedded agent API](https://github.com/NicholasZolton/SuperCmdK#agent)
- [Demo source](https://github.com/NicholasZolton/SuperCmdK/tree/main/demo)