feat(cli): publish runfusion.ai npm alias, lead install with npx runfusion.ai

Add a 633-byte shim package at packages/cli-alias/ published to npm as
`runfusion.ai@0.0.1`. Bare `npx runfusion.ai` boots the dashboard;
subcommands forward to the underlying @runfusion/fusion CLI so
`npx runfusion.ai task list` etc. Just Work. Both `runfusion.ai` and
`runfusion` bin names are exposed.

READMEs now lead the install story with `npx runfusion.ai` — the
shortest zero-install entry — and keep the longer `npx @runfusion/fusion
dashboard`, curl installer, Homebrew, and npm-global paths below.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
gsxdsm
2026-04-22 18:24:58 -07:00
parent 015a4e4cfe
commit 0c690dd94e
6 changed files with 106 additions and 2 deletions

View File

@@ -0,0 +1,40 @@
# runfusion.ai
Launch [Fusion](https://runfusion.ai) with a single npx:
```bash
npx runfusion.ai
```
That command boots the Fusion dashboard and AI engine on port 4040. Prints an `Open:` URL with a bearer token you can click to open in your browser.
## Subcommands
With no arguments, `runfusion.ai` defaults to `dashboard`. Any other subcommand is forwarded to the underlying [`fn` CLI](https://www.npmjs.com/package/@runfusion/fusion):
```bash
npx runfusion.ai # → fn dashboard
npx runfusion.ai task create "fix X" # → fn task create "fix X"
npx runfusion.ai --help # → fn --help
```
## How it relates to `@runfusion/fusion`
This package is a ~1 KB alias. It declares `@runfusion/fusion` as a dependency and its `bin` delegates to the same entrypoint. Use whichever name reads better:
```bash
npx runfusion.ai
npx @runfusion/fusion dashboard
```
For persistent installs, prefer Homebrew or `npm install -g @runfusion/fusion`.
## Links
- **Website:** [runfusion.ai](https://runfusion.ai)
- **Source:** [github.com/Runfusion/Fusion](https://github.com/Runfusion/Fusion)
- **Main package:** [@runfusion/fusion](https://www.npmjs.com/package/@runfusion/fusion)
## License
MIT

16
packages/cli-alias/index.js Executable file
View File

@@ -0,0 +1,16 @@
#!/usr/bin/env node
// runfusion.ai — tiny alias for @runfusion/fusion.
// With no args, launches the Fusion dashboard. With args, forwards to the
// underlying `fn` CLI so `npx runfusion.ai task list` etc. Just Work.
const args = process.argv.slice(2);
if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
// No subcommand → default to dashboard. Keep --help passthrough explicit
// so users can discover the full CLI surface via `npx runfusion.ai --help`.
if (args.length === 0) {
process.argv = [process.argv[0], process.argv[1], "dashboard"];
}
}
await import("@runfusion/fusion/dist/bin.js");

View File

@@ -0,0 +1,38 @@
{
"name": "runfusion.ai",
"version": "0.0.1",
"license": "MIT",
"description": "Launch Fusion with `npx runfusion.ai` — tiny alias for @runfusion/fusion.",
"homepage": "https://runfusion.ai",
"bugs": {
"url": "https://github.com/Runfusion/Fusion/issues"
},
"repository": {
"type": "git",
"url": "git+https://github.com/Runfusion/Fusion.git",
"directory": "packages/cli-alias"
},
"keywords": [
"fusion",
"runfusion",
"ai",
"agent",
"dashboard",
"cli"
],
"type": "module",
"bin": {
"runfusion.ai": "index.js",
"runfusion": "index.js"
},
"files": [
"index.js",
"README.md"
],
"publishConfig": {
"access": "public"
},
"dependencies": {
"@runfusion/fusion": "workspace:*"
}
}

View File

@@ -23,9 +23,11 @@
**Zero install, straight from npm:**
```bash
npx @runfusion/fusion dashboard
npx runfusion.ai
```
Boots the dashboard. Subcommands forward through (`npx runfusion.ai task list`, etc). Long form: `npx @runfusion/fusion dashboard`.
**One-line installer** (macOS & Linux — auto-picks Homebrew, falls back to npm):
```bash