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

package/README.md

@@ -4,17 +4,17 @@ Agent-first Notis CLI for apps and generic tool execution.
 
 ## Install
 
-The Notis CLI is bundled automatically with the Notis desktop app. Install and sign into Notis Desktop to install the `notis` command, write the local CLI config, and keep the bundled CLI, `notis-cli`, and `notis-apps` skills updated.
+Use the Notis CLI through NPX. Install and sign into Notis Desktop to keep the local CLI auth profile current; do not rely on an installed `notis` command. 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>`.
 
 ## Quick Start
 
 ```bash
-notis --help
-notis doctor
-notis apps list
-notis tools search "list Notis databases"
+npx --package @notis_ai/cli@latest -- notis --help
+npx --package @notis_ai/cli@latest -- notis doctor
+npx --package @notis_ai/cli@latest -- notis apps list
+npx --package @notis_ai/cli@latest -- notis tools search "list Notis databases"
 ```
 
 The desktop app owns sign-in and keeps the CLI profile in sync automatically.
@@ -33,17 +33,17 @@ The CLI defaults to `json` output in agent or non-TTY contexts and `table` outpu
 
 ## Apps
 
-### `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.
 
@@ -53,32 +53,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.
 
@@ -89,21 +89,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.
 
@@ -118,22 +118,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.
 
@@ -144,10 +144,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.
 
@@ -159,61 +159,58 @@ 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`
 
 
 ## Generic Tools
 
-### `notis tools toolkits`
+### `npx --package @notis_ai/cli@latest -- notis tools toolkits`
 
-List toolkit namespaces available to the active user.
+List toolkit namespaces and connection statuses available to the active user.
 
-When to use: Use this before searching or executing generic tools.
+When to use: Use this to inspect connection state before searching or executing generic tools.
 
 Examples:
-- `notis tools toolkits`
-- `notis tools toolkits --json`
+- `npx --package @notis_ai/cli@latest -- notis tools toolkits`
+- `npx --package @notis_ai/cli@latest -- notis tools toolkits --json`
 
-### `notis tools search <query>`
+### `npx --package @notis_ai/cli@latest -- notis tools search <query>`
 
 Search across toolkit namespaces using natural language.
 
 When to use: Use this when you need a generic capability that does not have a first-class CLI command.
 
 Options:
-- `--toolkits <csv-or-json>` — Optional subset of toolkit ids to search.
+- `--known-fields <text>` — Optional known field hints, such as channel_name:general or user_email:a@example.com.
 
 Examples:
-- `notis tools search "send an email"`
-- `notis tools search "update framer page" --toolkits mcp-framer`
+- `npx --package @notis_ai/cli@latest -- notis tools search "send an email"`
+- `npx --package @notis_ai/cli@latest -- notis tools search "post on LinkedIn" --known-fields "platform:linkedin"`
 
-### `notis tools describe <tool-name>`
+### `npx --package @notis_ai/cli@latest -- notis tools describe <tool-name>`
 
 Describe a generic tool by name.
 
 When to use: Use this when you know the tool name and want its parameter schema before execution.
 
-Options:
-- `--toolkits <csv-or-json>` — Optional subset of toolkit ids to search.
-
 Examples:
-- `notis tools describe composio-gmail-default-send_email`
-- `notis tools describe notis-default-query --toolkits notis-default`
+- `npx --package @notis_ai/cli@latest -- notis tools describe composio-gmail-default-send_email`
+- `npx --package @notis_ai/cli@latest -- notis tools describe notis-default-query`
 
-### `notis tools exec <tool-name>`
+### `npx --package @notis_ai/cli@latest -- notis tools exec <tool-name>`
 
 Execute a generic tool by canonical tool name.
 
@@ -221,69 +218,73 @@ When to use: Use this as the escape hatch for integrations or Notis tools withou
 
 Options:
 - `--arguments <json>` — JSON object, @file path, or - for stdin.
+- `--file <argument-path=local-path>` — Upload a local file into a file-uploadable tool argument. Repeatable.
 - `--get-schema` — Display the tool parameter schema without executing.
 - `--dry-run` — Validate arguments against the tool schema without executing.
-- `--toolkits <csv-or-json>` — Optional toolkit namespace(s) to use when resolving the tool.
 
 Examples:
-- `notis tools exec notis-default-query --arguments '{"database_slug":"tasks","query":{}}'`
-- `notis tools exec notis-default-get_database --arguments '{"database_slug":"tasks"}'`
-- `notis tools exec notis-default-query --get-schema`
-- `notis tools exec notis-default-query --dry-run --arguments '{"database_slug":"tasks","query":{}}'`
-- `notis tools exec notis-default-query --arguments @query.json`
-- `notis tools exec notis-default-query --arguments - < query.json`
+- `npx --package @notis_ai/cli@latest -- notis tools exec notis-default-query --arguments '{"database_slug":"tasks","query":{}}'`
+- `npx --package @notis_ai/cli@latest -- notis tools exec notis-default-get_database --arguments '{"database_slug":"tasks"}'`
+- `npx --package @notis_ai/cli@latest -- notis tools exec notis-default-query --get-schema`
+- `npx --package @notis_ai/cli@latest -- notis tools exec notis-default-query --dry-run --arguments '{"database_slug":"tasks","query":{}}'`
+- `npx --package @notis_ai/cli@latest -- notis tools exec notis-default-query --arguments @query.json`
+- `npx --package @notis_ai/cli@latest -- notis tools exec notis-default-query --arguments - < query.json`
+- `npx --package @notis_ai/cli@latest -- notis tools exec composio-dropbox-default-upload_file --arguments '{"path":"/target/in/dropbox.pdf"}' --file content=./Invoice.pdf`
 
-### `notis tools exec-parallel <calls>`
+### `npx --package @notis_ai/cli@latest -- notis tools exec-parallel <calls>`
 
 Execute multiple tools concurrently.
 
 When to use: Use this when you need to run independent tool calls simultaneously for speed.
 
+Options:
+- `--file <argument-path=local-path>` — Unsupported for exec-parallel; use tools exec for file uploads.
+
 Examples:
-- `notis tools exec-parallel '[{"tool_name":"notis-default-query","arguments":{"database_slug":"tasks","query":{}}},{"tool_name":"notis-default-list_databases","arguments":{}}]'`
+- `npx --package @notis_ai/cli@latest -- notis tools exec-parallel '[{"tool_name":"notis-default-query","arguments":{"database_slug":"tasks","query":{}}},{"tool_name":"notis-default-list_databases","arguments":{}}]'`
 
-### `notis tools link <toolkit>`
+### `npx --package @notis_ai/cli@latest -- notis tools link <toolkit>`
 
 Get the URL to connect an integration toolkit.
 
 When to use: Use this when a tool requires authentication with an external service.
 
 Examples:
-- `notis tools link github`
-- `notis tools link gmail --json`
+- `npx --package @notis_ai/cli@latest -- notis tools link github`
+- `npx --package @notis_ai/cli@latest -- notis tools link gmail --json`
 
 
 ## Meta 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 whoami`
+### `npx --package @notis_ai/cli@latest -- notis whoami`
 
-Display the active profile, user, and available toolkits.
+Display the active profile, user, and available toolkit connection statuses.
 
 When to use: Use this to quickly confirm which account and environment a command will target.
 
 Examples:
-- `notis whoami`
-- `notis whoami --json`
+- `npx --package @notis_ai/cli@latest -- notis whoami`
+- `npx --package @notis_ai/cli@latest -- notis whoami --json`
 
-### `notis describe <command...>`
+### `npx --package @notis_ai/cli@latest -- notis describe <command...>`
 
 Describe a first-class CLI command in detail.
 
 When to use: Use this when an agent or human needs the exact shape, examples, and semantics of a command.
 
 Examples:
-- `notis describe apps deploy`
-- `notis describe tools exec`
+- `npx --package @notis_ai/cli@latest -- notis describe apps deploy`
+- `npx --package @notis_ai/cli@latest -- notis describe tools exec`
 
 
 ## Local Development

package/dist/scaffolds/notis-database/app/globals.css

@@ -0,0 +1,44 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+/*
+ * The portal mounts the app inside [data-notis-app-root] (display: block,
+ * min-height: 100% from @notis/sdk/styles.css). Width 100% ensures the
+ * two-pane layout can stretch to the full content area; height stays on
+ * the SDK's min-height: 100% default so the page can grow with content.
+ * The page itself uses `h-screen` to guarantee a fixed viewport height
+ * for the two-pane divider and centered empty states.
+ */
+[data-notis-app-root] {
+  width: 100%;
+}
+
+/*
+ * Dev-preview fallback tokens. Active only when the dev entrypoint sets the
+ * data-dev-preview attribute. Production bundle runs inside the portal
+ * shadow root where the host injects real theme tokens, so this rule is
+ * scoped narrowly enough to never collide with portal-provided values.
+ */
+[data-dev-preview] {
+  --background: 0 0% 100%;
+  --foreground: 0 0% 4%;
+  --card: 0 0% 100%;
+  --card-foreground: 0 0% 4%;
+  --popover: 0 0% 100%;
+  --popover-foreground: 0 0% 4%;
+  --primary: 0 0% 9%;
+  --primary-foreground: 0 0% 98%;
+  --secondary: 240 5% 96%;
+  --secondary-foreground: 0 0% 9%;
+  --muted: 240 5% 96%;
+  --muted-foreground: 240 4% 46%;
+  --accent: 240 5% 96%;
+  --accent-foreground: 0 0% 9%;
+  --destructive: 0 84% 60%;
+  --destructive-foreground: 0 0% 98%;
+  --border: 240 6% 90%;
+  --input: 240 6% 90%;
+  --ring: 0 0% 4%;
+  --radius: 0.5rem;
+}