@maintainer-pro/ai-cli 0.1.1 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -6
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,8 +1,10 @@
|
|
|
1
1
|
# @maintainer-pro/ai-cli
|
|
2
2
|
|
|
3
|
-
Server SDK for Maintainer Pro. It talks to coding agents — Cursor (`agent`), Claude (`claude`), or Antigravity (`agy`) — and exposes chat HTTP handlers
|
|
3
|
+
Server SDK for Maintainer Pro. It talks to coding agents — Cursor (`agent`), Claude (`claude`), or Antigravity (`agy`) — and exposes chat HTTP handlers.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
**Local development:** prefer [`@maintainer-pro/ai-server`](https://www.npmjs.com/package/@maintainer-pro/ai-server) as a sidecar (a separate Node chat server beside the host app). Do not add chat routes to the host.
|
|
6
|
+
|
|
7
|
+
**Production:** use this SDK on a machine that can run a coding-agent CLI, or pass a custom `AiProvider`. HTTP model backends are out of scope for the default providers. The embed widget (`ai-ui.iife.js`) must be served as a static file in production — `localhost` sidecar URLs will not load.
|
|
6
8
|
|
|
7
9
|
## Install
|
|
8
10
|
|
|
@@ -10,7 +12,7 @@ Use this package when you already have a server (Next, Express, Fastify). To get
|
|
|
10
12
|
npm install @maintainer-pro/ai-cli
|
|
11
13
|
```
|
|
12
14
|
|
|
13
|
-
Requires **Node.js 22+** and one authenticated coding-agent CLI on the machine that runs chat.
|
|
15
|
+
Requires **Node.js 22+** and one authenticated coding-agent CLI on the machine that runs chat (unless you supply `providers`).
|
|
14
16
|
|
|
15
17
|
## Quick start
|
|
16
18
|
|
|
@@ -38,7 +40,7 @@ export const GET = handlers.GET;
|
|
|
38
40
|
export const POST = handlers.POST;
|
|
39
41
|
```
|
|
40
42
|
|
|
41
|
-
Chat history is stored in Maintainer Pro admin. Do not put API keys in the browser
|
|
43
|
+
Chat history is stored in Maintainer Pro admin. Do not put API keys in the browser — serve the client key from `/embed-config.js`.
|
|
42
44
|
|
|
43
45
|
## Environment
|
|
44
46
|
|
|
@@ -54,8 +56,8 @@ Chat history is stored in Maintainer Pro admin. Do not put API keys in the brows
|
|
|
54
56
|
|
|
55
57
|
| Package | Role |
|
|
56
58
|
|---------|------|
|
|
57
|
-
| [`@maintainer-pro/ai-server`](https://www.npmjs.com/package/@maintainer-pro/ai-server) |
|
|
58
|
-
| [`@maintainer-pro/ai-ui`](https://www.npmjs.com/package/@maintainer-pro/ai-ui) |
|
|
59
|
+
| [`@maintainer-pro/ai-server`](https://www.npmjs.com/package/@maintainer-pro/ai-server) | Local Node chat server (sidecar) that uses this SDK |
|
|
60
|
+
| [`@maintainer-pro/ai-ui`](https://www.npmjs.com/package/@maintainer-pro/ai-ui) | Embed widget (`ai-ui.iife.js`) — sidecar in dev, static file in prod |
|
|
59
61
|
| [`@maintainer-pro/setup`](https://www.npmjs.com/package/@maintainer-pro/setup) | Download the sandbox setup guide |
|
|
60
62
|
|
|
61
63
|
Optional SQL persistence lives on `@maintainer-pro/ai-cli/db` (install `better-sqlite3`, `postgres`, or `mysql2`).
|