Await is a widget workshop for people who like crafting small things.
Start from templates or from scratch — arrange layouts, try out interactions, and tune the style with panels. Turn your ideas into home screen widgets, with a bit of your own taste.
Await is local-first. Your widgets and data stay with you.
This repository provides the public Await Widget and widget template used to create Await widgets.
This is an installable skill and template repo for AI agents to create Await widgets.
Install via npx skills, which works across Claude Code, Codex, Cursor, OpenCode, Gemini CLI, and 40+ other agents.
# Project-scoped (committed with your project, shared with team)
npx skills add await-widget/skills
# User-scoped (available across all your projects)
npx skills add await-widget/skills -g
# Install only to a specific agent
npx skills add await-widget/skills -a claude-code -gRestart your agent after installing.
The install bundles the widget instructions and template into your agent's skills directory. The skill registers as await-widget in your agent's skill list, and widget projects use the published @await-widget/runtime package for TypeScript declarations.
See vercel-labs/skills for the full list of supported agents and CLI options.
Widget projects should install the Await runtime declarations from npm:
npm install -D @await-widget/runtime typescriptConfigure TypeScript to use the Await JSX runtime and global bridge declarations:
{
"compilerOptions": {
"jsx": "react-jsx",
"jsxImportSource": "await",
"types": ["@await-widget/runtime"]
}
}Widget source continues to import components from await:
import { Text, ZStack } from "await";
function widget() {
return (
<ZStack>
<Text value="Hello, World!" />
</ZStack>
);
}
Await.define({
widget,
});@await-widget/runtime provides the await module, await/jsx-runtime, global Await bridge APIs such as Await, AwaitStore, and AwaitNetwork, and JSX constraints for Await widgets.
git clone https://github.com/await-widget/skills.git
cd skills
cd assets
npm install
npm testRead `SKILL.md` first and follow it strictly.
Then implement or modify the target widget based on my request.
SKILL.md is the main instruction file for agents in this repo.
assets/ is the template project root.
MIT