0.0.5 • Published 2d agoCLI

create-ryu-app

Licence

—

Version

0.0.5

Deps

Size

35 kB

Vulns

Weekly

Summary Dependency Versions

create-ryu-app

Scaffold a starter Ryu SDK project in one command. Part of Ryu.

create-ryu-app is the project scaffolder for the Ryu SDK. Running it generates a starter project with a Runnable, a gateway-pointed model config, and a plugin.json (legacy ryu.json) manifest validated against the PluginManifest schema, so a new plugin compiles and packs out of the box. It depends on @ryuhq/sdk by semver.

Pick a starter with --template (default agent):

Template	Emits	Factory
`agent`	A loop-owning Runnable agent	`Agent` / `ryuTool`
`hook-plugin`	A post-assistant-turn plugin	`definePlugin` + `defineTurnHook`
`ryu-app`	An interactive in-chat widget	`defineApp` + a self-contained widget
`companion-plugin`	A Ryu App whose widget calls a companion tool, plus a panel surface	`defineApp`

Tier: OSS, Apache-2.0

Install / Build

# scaffold a new project (default: agent template)
bunx create-ryu-app <name>

# scaffold a specific template
bunx create-ryu-app <name> --template ryu-app

# build from source
bun run build   # tsup → dist/
bun test

What it provides

A one-command scaffolder (create-ryu-app <name> [--template <t>]) bundled with a template/<name>/ tree per starter.
A generated starter Runnable plus a gateway-pointed model config.
A plugin.json / ryu.json manifest validated against the PluginManifest schema, ready for ryu pack.

License

Apache-2.0. See LICENSE. 2026 A Major Pte. Ltd.