@notis_ai/cli 0.2.0-beta.35.1 → 0.2.0-beta.41.1

package/dist/scaffolds.json

@@ -2,12 +2,35 @@
   "source": "apps/*/notis.config.ts",
   "scaffolds": [
     {
-      "slug": "notes",
+      "slug": "notis-database",
+      "name": "Databases",
+      "description": "Read-only catalog and schema explorer for every database in your Notis workspace.",
+      "icon": "phosphor:database",
+      "categories": [
+        "Product & Engineering",
+        "Operations"
+      ],
+      "tagline": "Explore every database and schema in your Notis workspace."
+    },
+    {
+      "slug": "notis-notes",
       "name": "Notis Notes",
       "description": "Browse notes by documents, table, or calendar with folders in the sidebar.",
-      "icon": "lucide:notebook-pen",
-      "categories": [],
-      "tagline": "Browse notes by documents, table, or calendar with folders in the sidebar."
+      "icon": "phosphor:note-pencil",
+      "categories": [
+        "Productivity"
+      ],
+      "tagline": "Folder-based notes with gallery, table, and calendar views."
+    },
+    {
+      "slug": "notis-random",
+      "name": "Random Number Generator",
+      "description": "Generate random numbers with configurable bounds, and keep a history of everything you rolled.",
+      "icon": "phosphor:dice-five",
+      "categories": [
+        "Personal"
+      ],
+      "tagline": "Roll dice, keep history."
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@notis_ai/cli",
-  "version": "0.2.0-beta.35.1",
+  "version": "0.2.0-beta.41.1",
   "description": "Agent-first Notis CLI for apps and generic tool execution",
   "type": "module",
   "bin": {

package/skills/notis-apps/SKILL.md

@@ -7,7 +7,7 @@ description: Design and package Notis apps. Use when users want an app that grou
 
 Use this skill when the user wants to create, edit, debug, or package a Notis app. Notis apps are Vite + React projects that deploy into the Notis Portal as installed apps for the current user or team.
 
-The Notis desktop app automatically installs and keeps this `notis-apps` skill updated alongside the `notis-cli` skill for local agents. No separate manual skill install is needed on desktop.
+Run the Notis CLI through NPX, for example `npx --package @notis_ai/cli@latest -- notis apps list`. Notis Desktop keeps the CLI auth profile current. This `notis-apps` skill is delivered through normal Notis skill sync for the signed-in user, alongside other curated skills.
 
 ## Platform Model
 
@@ -23,27 +23,21 @@ A Notis app is:
 Use the Notis CLI for the app lifecycle:
 
 ```bash
-notis apps init
-notis apps dev
-notis apps build
-notis apps verify
-notis apps create
-notis apps link
-notis apps pull
-notis apps deploy
-notis apps doctor
+npx --package @notis_ai/cli@latest -- notis apps init
+npx --package @notis_ai/cli@latest -- notis apps dev
+npx --package @notis_ai/cli@latest -- notis apps build
+npx --package @notis_ai/cli@latest -- notis apps verify
+npx --package @notis_ai/cli@latest -- notis apps create
+npx --package @notis_ai/cli@latest -- notis apps link
+npx --package @notis_ai/cli@latest -- notis apps pull
+npx --package @notis_ai/cli@latest -- notis apps deploy
+npx --package @notis_ai/cli@latest -- notis apps doctor
 ```
 
-When working in a local repo workspace, prefer the repo-local CLI entrypoint if available:
+Use this command form everywhere:
 
 ```bash
-node packages/cli/bin/notis.js apps ...
-```
-
-When working outside a repo with the desktop-installed CLI, use:
-
-```bash
-notis apps ...
+npx --package @notis_ai/cli@latest -- notis apps ...
 ```
 
 ## Hard Rules
@@ -55,7 +49,7 @@ notis apps ...
 - Declare runtime tool access in `notis.config.ts` `tools`.
 - Use `@notis/sdk` hooks instead of direct runtime access.
 - Do not rely on `window.__NOTIS_RUNTIME__` or portal-owned DOM hooks.
-- `notis apps deploy` updates an installed app. It does not publish to the public App Store.
+- `npx --package @notis_ai/cli@latest -- notis apps deploy` updates an installed app. It does not publish to the public App Store.
 - Public or team App Store publishing is a Portal review flow.
 - Use Phosphor icon names with the `phosphor:` prefix. Do not use emoji icons.
 - Prefer scaffolded shadcn components and portal theme tokens over custom visual systems.
@@ -65,43 +59,43 @@ notis apps ...
 1. Discover existing apps if needed:
 
 ```bash
-notis apps list
+npx --package @notis_ai/cli@latest -- notis apps list
 ```
 
 2. Start from a scaffold or pull an existing app:
 
 ```bash
-notis apps scaffolds list
-notis apps init "My App"
-notis apps pull <app-id> ./my-app
+npx --package @notis_ai/cli@latest -- notis apps scaffolds list
+npx --package @notis_ai/cli@latest -- notis apps init "My App"
+npx --package @notis_ai/cli@latest -- notis apps pull <app-id> ./my-app
 ```
 
 3. Install dependencies and develop:
 
 ```bash
 npm install
-notis apps dev
+npx --package @notis_ai/cli@latest -- notis apps dev
 ```
 
 4. Build and verify:
 
 ```bash
-notis apps build
-notis apps verify
+npx --package @notis_ai/cli@latest -- notis apps build
+npx --package @notis_ai/cli@latest -- notis apps verify
 ```
 
 5. Create or link the remote app, then deploy:
 
 ```bash
-notis apps create "My App" .
-notis apps deploy
+npx --package @notis_ai/cli@latest -- notis apps create "My App" .
+npx --package @notis_ai/cli@latest -- notis apps deploy
 ```
 
 or:
 
 ```bash
-notis apps link <app-id>
-notis apps deploy
+npx --package @notis_ai/cli@latest -- notis apps link <app-id>
+npx --package @notis_ai/cli@latest -- notis apps deploy
 ```
 
 ## App Structure
@@ -162,7 +156,7 @@ Do not fetch Notis backend endpoints directly from app code unless the SDK expli
 
 ## Troubleshooting
 
-- If deploy fails with backend connectivity errors, run `notis apps doctor` and check the configured API base.
-- If editing an existing app, use `notis apps pull <app-id>` when source snapshots are available.
+- If deploy fails with backend connectivity errors, run `npx --package @notis_ai/cli@latest -- notis apps doctor` and check the configured API base.
+- If editing an existing app, use `npx --package @notis_ai/cli@latest -- notis apps pull <app-id>` when source snapshots are available.
 - If the Portal shows a stale bundle, hard refresh the Portal or deploy a new version.
-- If an app route fails to load, run `notis apps verify` and inspect `.notis/output/manifest.json`.
+- If an app route fails to load, run `npx --package @notis_ai/cli@latest -- notis apps verify` and inspect `.notis/output/manifest.json`.

package/skills/notis-apps/cli.md

@@ -8,7 +8,7 @@ Important: `notis apps deploy` updates the linked installed app. It is not an ap
 
 ## Setup
 
-Install and sign into Notis Desktop. The desktop app installs the `notis` command, keeps the CLI profile current, and automatically installs the built-in `notis-cli` and `notis-apps` skills for local agents.
+Install and sign into Notis Desktop to keep the CLI profile current. Run the CLI through NPX, for example `npx --package @notis_ai/cli@latest -- notis apps list`. Related skills such as `notis-cli` and `notis-apps` are delivered through normal Notis skill sync for the signed-in user.
 
 For CI, hosted agents, or internal scripts, pass a non-persisted token with `NOTIS_JWT=<token>` and use `--api-base <server-url>` when targeting a non-default server.
 
@@ -17,13 +17,13 @@ For CI, hosted agents, or internal scripts, pass a non-persisted token with `NOT
 1. Scaffold a new app:
 
 ```bash
-notis apps init
+npx --package @notis_ai/cli@latest -- notis apps init
 ```
 
 2. Or pull an installed app's saved source snapshot:
 
 ```bash
-notis apps pull <app-id> ./my-app
+npx --package @notis_ai/cli@latest -- notis apps pull <app-id> ./my-app
 cd ./my-app
 npm install
 ```
@@ -31,51 +31,51 @@ npm install
 3. Develop locally with live reload:
 
 ```bash
-notis apps dev
+npx --package @notis_ai/cli@latest -- notis apps dev
 ```
 
 4. Build the production artifact:
 
 ```bash
-notis apps build
+npx --package @notis_ai/cli@latest -- notis apps build
 ```
 
 5. Verify the built artifact headlessly:
 
 ```bash
-notis apps verify
+npx --package @notis_ai/cli@latest -- notis apps verify
 ```
 
 6. Link the project if it was not created or pulled from an app, then deploy:
 
 ```bash
-notis apps link <app-id>
-notis apps deploy
+npx --package @notis_ai/cli@latest -- notis apps link <app-id>
+npx --package @notis_ai/cli@latest -- notis apps deploy
 ```
 
 ## Commands
 
-### `notis doctor`
+### `npx --package @notis_ai/cli@latest -- notis doctor`
 
 Run a quick CLI health check for config, auth, and API reachability.
 
 When to use: Use this before relying on the CLI in automation or after changing environments.
 
 Examples:
-- `notis doctor`
-- `notis doctor --json`
+- `npx --package @notis_ai/cli@latest -- notis doctor`
+- `npx --package @notis_ai/cli@latest -- notis doctor --json`
 
-### `notis apps list`
+### `npx --package @notis_ai/cli@latest -- notis apps list`
 
 List apps the current profile can access.
 
 When to use: Discover existing apps before linking or deploying.
 
 Examples:
-- `notis apps list`
-- `notis apps list --json`
+- `npx --package @notis_ai/cli@latest -- notis apps list`
+- `npx --package @notis_ai/cli@latest -- notis apps list --json`
 
-### `notis apps init <name> [dir]`
+### `npx --package @notis_ai/cli@latest -- notis apps init <name> [dir]`
 
 Scaffold a new Notis app project.
 
@@ -85,32 +85,32 @@ Options:
 - `--from <slug>` — Start from a bundled scaffold listed by `notis apps scaffolds list`.
 
 Examples:
-- `notis apps scaffolds list`
-- `notis apps init "Mind the Flo"`
-- `notis apps init "My CRM" --from notis-database`
-- `notis apps init "My App" ./my-app`
+- `npx --package @notis_ai/cli@latest -- notis apps scaffolds list`
+- `npx --package @notis_ai/cli@latest -- notis apps init "Mind the Flo"`
+- `npx --package @notis_ai/cli@latest -- notis apps init "My CRM" --from notis-database`
+- `npx --package @notis_ai/cli@latest -- notis apps init "My App" ./my-app`
 
-### `notis apps scaffolds list`
+### `npx --package @notis_ai/cli@latest -- notis apps scaffolds list`
 
 List bundled Notis app scaffolds.
 
 When to use: Discover the fixed scaffold catalog shipped with the CLI before starting a new app.
 
 Examples:
-- `notis apps scaffolds list`
-- `notis apps init "My App" --from notis-database`
+- `npx --package @notis_ai/cli@latest -- notis apps scaffolds list`
+- `npx --package @notis_ai/cli@latest -- notis apps init "My App" --from notis-database`
 
-### `notis apps create <name> [dir]`
+### `npx --package @notis_ai/cli@latest -- notis apps create <name> [dir]`
 
 Create a new remote Notis app and optionally link a local project to it.
 
 When to use: Provision a fresh remote app before the first deploy. Pass a project directory to link it immediately.
 
 Examples:
-- `notis apps create "My App"`
-- `notis apps create "My App" .`
+- `npx --package @notis_ai/cli@latest -- notis apps create "My App"`
+- `npx --package @notis_ai/cli@latest -- notis apps create "My App" .`
 
-### `notis apps dev [dir]`
+### `npx --package @notis_ai/cli@latest -- notis apps dev [dir]`
 
 Develop Notis apps inside the Electron desktop Portal with automatic local bundle reloads.
 
@@ -121,21 +121,21 @@ Options:
 - `--no-open` — Do not auto-open the desktop Portal local development app.
 
 Examples:
-- `notis apps dev`
-- `notis apps dev ./my-app`
-- `notis apps dev ./workspace --port 5200`
+- `npx --package @notis_ai/cli@latest -- notis apps dev`
+- `npx --package @notis_ai/cli@latest -- notis apps dev ./my-app`
+- `npx --package @notis_ai/cli@latest -- notis apps dev ./workspace --port 5200`
 
-### `notis apps build [dir]`
+### `npx --package @notis_ai/cli@latest -- notis apps build [dir]`
 
 Build and package the app into .notis/output/.
 
 When to use: Prepare the app for verification or deployment.
 
 Examples:
-- `notis apps build`
-- `notis apps build ./my-app`
+- `npx --package @notis_ai/cli@latest -- notis apps build`
+- `npx --package @notis_ai/cli@latest -- notis apps build ./my-app`
 
-### `notis apps verify [dir]`
+### `npx --package @notis_ai/cli@latest -- notis apps verify [dir]`
 
 Headless render smoke each route in a stub-runtime harness.
 
@@ -150,22 +150,22 @@ Options:
 - `--keep-open` — Leave server + browser session running after report (for manual triage).
 
 Examples:
-- `notis apps verify`
-- `notis apps verify --routes notes`
-- `notis apps verify --mode live`
-- `notis apps verify --no-browser  # start the harness, drive agent-browser yourself`
+- `npx --package @notis_ai/cli@latest -- notis apps verify`
+- `npx --package @notis_ai/cli@latest -- notis apps verify --routes notes`
+- `npx --package @notis_ai/cli@latest -- notis apps verify --mode live`
+- `npx --package @notis_ai/cli@latest -- notis apps verify --no-browser  # start the harness, drive agent-browser yourself`
 
-### `notis apps link <app-id> [dir]`
+### `npx --package @notis_ai/cli@latest -- notis apps link <app-id> [dir]`
 
 Link a local project to a remote Notis app.
 
 When to use: Connect a local project to an existing app for deployment.
 
 Examples:
-- `notis apps link abc123`
-- `notis apps link abc123 ./my-app`
+- `npx --package @notis_ai/cli@latest -- notis apps link abc123`
+- `npx --package @notis_ai/cli@latest -- notis apps link abc123 ./my-app`
 
-### `notis apps pull <app-id> [dir]`
+### `npx --package @notis_ai/cli@latest -- notis apps pull <app-id> [dir]`
 
 Download a Notis app source snapshot into a local project folder.
 
@@ -176,10 +176,10 @@ Options:
 - `--version <n>` — Pull a specific app source version (default: latest).
 
 Examples:
-- `notis apps pull abc123`
-- `notis apps pull abc123 ./my-app --force`
+- `npx --package @notis_ai/cli@latest -- notis apps pull abc123`
+- `npx --package @notis_ai/cli@latest -- notis apps pull abc123 ./my-app --force`
 
-### `notis apps deploy [dir]`
+### `npx --package @notis_ai/cli@latest -- notis apps deploy [dir]`
 
 Build and upload the app to the linked Notis app.
 
@@ -191,18 +191,18 @@ Options:
 - `--direct` — Upload directly to Supabase storage, bypassing the backend server. Auto-fallback on network errors.
 
 Examples:
-- `notis apps deploy`
-- `notis apps deploy --skip-build`
-- `notis apps deploy --app-id abc123`
-- `notis apps deploy --direct`
+- `npx --package @notis_ai/cli@latest -- notis apps deploy`
+- `npx --package @notis_ai/cli@latest -- notis apps deploy --skip-build`
+- `npx --package @notis_ai/cli@latest -- notis apps deploy --app-id abc123`
+- `npx --package @notis_ai/cli@latest -- notis apps deploy --direct`
 
-### `notis apps doctor [dir]`
+### `npx --package @notis_ai/cli@latest -- notis apps doctor [dir]`
 
 Check project health and readiness.
 
 When to use: Diagnose issues with a Notis app project.
 
 Examples:
-- `notis apps doctor`
-- `notis apps doctor ./my-app`
+- `npx --package @notis_ai/cli@latest -- notis apps doctor`
+- `npx --package @notis_ai/cli@latest -- notis apps doctor ./my-app`