create-curb.js 1.16.0-preview.9 → 1.17.0-preview.1

package/README.md

@@ -1,14 +1,57 @@
-# create-curb.js
+<div align="center">
+  <a href="https://curbjs.com"><img alt="Curb" src="https://curbjs.com/og.png?v=2" width="360"></a>
+  <h1>create-curb.js</h1>
+  <p><strong>The framework for production voice agents.</strong></p>
+  <p>Dynamic prompting with full control, in plain code you own. Your coding agent can build, test, and simulate conversations before it ships.</p>
+  <a href="https://www.npmjs.com/package/create-curb.js"><img alt="npm version" src="https://img.shields.io/npm/v/create-curb.js.svg?style=for-the-badge&labelColor=000000"></a>
+  <a href="https://curbjs.com/docs/installation/"><img alt="Node.js version" src="https://img.shields.io/node/v/create-curb.js.svg?style=for-the-badge&labelColor=000000"></a>
+  <a href="https://www.apache.org/licenses/LICENSE-2.0"><img alt="License" src="https://img.shields.io/npm/l/create-curb.js.svg?style=for-the-badge&labelColor=000000"></a>
+</div>
 
-Create a voice agent on KugelAudio:
+`create-curb.js` creates a Curb voice agent in one command. You need Node.js 22.12 or newer.
 
-```sh
+```bash
 npm create curb.js my-agent
 cd my-agent
-npx curb login
-npm run dev
+npx curb login         # sign in once in the browser
+npm run dev            # open http://127.0.0.1:4000
 ```
 
-`npx curb login` signs you in once in your browser. `npm run dev` gives you a link to talk to your agent.
+`npx curb login` signs you in once in your browser. `npm run dev` gives you a link to talk to your
+agent. Run `npm create curb.js .` to create the project in an empty folder instead. `npm create
+curb` is the same installer under a shorter name.
+
+The framework's package is `curb.js`, not `curb`, which is unrelated. The project depends on it
+through an alias, `"curb": "npm:curb.js@<version>"`, so your code imports from `"curb"`.
+
+## Providers
+
+The defaults run speech-to-text, the LLM and text-to-speech on KugelAudio with one sign-in. Nothing
+is asked: flags after `--` pick other providers, and their API keys are read from the environment.
+
+```bash
+npm create curb.js my-agent -- --llm anthropic --tts elevenlabs
+```
+
+| Flag | Providers |
+| --- | --- |
+| `--stt` | `kugelaudio`, `azure`, `deepgram`, `elevenlabs`, `openai` |
+| `--llm` | `kugelaudio`, `anthropic`, `openai`, `openai-compatible` |
+| `--tts` | `kugelaudio`, `cartesia`, `elevenlabs`, `openai` |
+
+`npm create curb.js -- --help` lists every option.
+
+## Previews
 
 To try the newest preview, create the project with `npm create curb.js@preview my-agent`.
+
+## Documentation
+
+- [Installation](https://curbjs.com/docs/installation/): create a project and talk to it.
+- [Project structure](https://curbjs.com/docs/project-structure/): what the installer created.
+- [All docs](https://curbjs.com/docs/) on curbjs.com.
+
+## License
+
+Licensed under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).
+Copyright 2026 KugelAudio GmbH. Built by [KugelAudio](https://kugelaudio.com).

package/RELEASE_NOTES.md

@@ -1,14 +1,5 @@
 
-### Added
-
-- Make npm the only way to get and update Curb (#36)
-
-
 ### Fixed
 
-- Refuse unknown arguments to curb upgrade (#39)
-- Explain a target folder that cannot be created (#40)
-- Say what hosted deploys accept today (#46)
-- Correct what the help and guide say about conversations and build (#41)
-- Start curb outside a project from the npm package (#38)
+- Name every skill link, keep a first message, and rebuild the API reference (#55)
 

package/package.json

@@ -1,12 +1,34 @@
 {
   "name": "create-curb.js",
-  "version": "1.16.0-preview.9",
-  "description": "Create a Curb voice agent: npm create curb.js my-agent",
+  "version": "1.17.0-preview.1",
+  "description": "Create a Curb voice agent with one command. The framework for production voice agents.",
+  "keywords": [
+    "curb",
+    "curb.js",
+    "scaffold",
+    "starter",
+    "template",
+    "cli",
+    "voice-agent",
+    "voice-ai",
+    "agent-framework",
+    "conversational-ai",
+    "react",
+    "typescript"
+  ],
   "license": "Apache-2.0",
+  "author": {
+    "name": "KugelAudio GmbH",
+    "url": "https://kugelaudio.com"
+  },
   "homepage": "https://curbjs.com",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Kugelaudio/curb.js.git"
+    "url": "git+https://github.com/Kugelaudio/curb.js.git",
+    "directory": "packages/create-curb.js"
+  },
+  "bugs": {
+    "url": "https://curbjs.com/docs/reporting-a-bug/"
   },
   "type": "module",
   "engines": {

package/templates/default/AGENTS.md

@@ -143,9 +143,9 @@ hosted deploys accept the project.
 `.mcp.json` registers two MCP servers for Claude Code started in this folder (it asks once
 to use them): `kugelaudio`, your KugelAudio account (sign in from `/mcp`), and
 `kugelaudio-docs`, the docs (no sign-in). Another client adds
-`https://www.kugelaudio.com/mcp` as a remote MCP server. Look KugelAudio facts up with
-`search_docs` and `read_docs_page`; for hosted agents use the `kugelaudio` server's,
-since `kugelaudio-docs` serves public pages only. Deploy and read build and call logs
+`https://www.kugelaudio.com/mcp` as a remote MCP server. Look KugelAudio and Curb facts up
+with `search_docs` and `read_docs_page` (site `"curb"` for Curb); for hosted agents use the
+`kugelaudio` server's, since `kugelaudio-docs` serves public pages only. Deploy and read build and call logs
 with the `kugelaudio` tools: `agent_create` (once), `agent_create_upload`, `agent_deploy`,
 `agent_get_logs`; keys reach it only through `npx curb secrets push`. Without them: