adaptiqai 0.1.1 → 0.2.0

package/README.md

@@ -4,32 +4,53 @@ One command that connects the AI app you use to [AdaptiqAI](https://adaptiqai.co
 for a person at a terminal and for an agent running it unattended.
 
 ```bash
-npx -y adaptiqai connect cline
+npx -y adaptiqai
 ```
 
-It signs you in through your browser, sets the app up, sends one test request,
-and says how to start the app. You open one link, press Connect, and add a card
-or funds. Nothing else needs doing by hand, and there is no key to copy.
+It asks which app you want, gets it if it is not on your computer, signs you in
+through your browser, sets the app up, sends one test request, and says how to
+start the app; at a terminal it offers to start it there and then. You open one
+link, press Connect, and add funds. Nothing else needs doing by hand, and there
+is no key to copy.
 
 | Command | |
 |---|---|
+| `npx -y adaptiqai` | Pick the app, then connect it. |
 | `npx -y adaptiqai connect <app>` | Sign in, set the app up, test it. Safe to run again. |
 | `npx -y adaptiqai status [app]` | Where each app stands. Uses no model. |
 | `npx -y adaptiqai disconnect <app>` | Take AdaptiqAI out of the app, and put back what it replaced. |
 
-`npx -y adaptiqai` on its own connects the one app it finds, or asks which.
+Everything goes by what you want, not by what this computer has:
+
+- **Every app is offered.** `npx -y adaptiqai` lists them all, the ones on this
+  computer marked, and you pick.
+- **An app that is not here is got first, on your yes.** Where it has a Mac app
+  this works with (DeepSeek Harness, OpenCode, Hermes), you choose: download the
+  app, which opens its maker's page and goes on once it is installed, or run it
+  in the terminal. Otherwise its maker's own installer runs in this terminal,
+  where it can ask its own questions (on Windows, only those that npm runs).
+- **A newer Node.js, where an app needs one,** is installed on your yes by
+  AdaptiqAI's install script, in `~/.adaptiq/node` with no admin password, and
+  the command goes on there: DeepSeek Harness in the browser asks for 24.9,
+  and OpenClaw's installer for 24.16.
+  Without Node.js at all, start with that script:
+
+  ```bash
+  curl -fsSL https://api.adaptiqai.com/v1/install.sh | sh
+  ```
+
+An agent is asked nothing: it is told the ways, for the person to choose.
 
 | App | Word | What it sets up | Start it with |
 |---|---|---|---|
-| Cline | `cline` | A provider of its own, in every Cline app on this computer | the app, or `cline` |
 | DeepSeek Harness | `deepseek` | AdaptiqAI's plugin, in its app or in the browser | the app, or `npx -y @deepseek-ai/dsh adaptiq` |
-| Codex | `codex` | A profile and a model catalog of its own, as Connect to app writes them. Plain `codex` stays as it was | `codex --profile adaptiq` |
-| Claude Code | `claude-code` | `adaptiq-claude`. Plain `claude` stays as it was | `adaptiq-claude` |
+| Codex | `codex` | A profile and a model catalog of its own, brought up to the workspace's models once a day, with AdaptiqAI's knowledge tools, as Connect to app writes them. Plain `codex` stays as it was | `codex --profile adaptiq` |
+| Claude Code | `claude-code` | `adaptiq-claude`, with AdaptiqAI's knowledge tools and the workspace's models in `/model`. Plain `claude` stays as it was | `adaptiq-claude` |
 | OpenCode | `opencode` | OpenCode's own sign-in | `opencode` |
 | Kilo Code | `kilo` | Kilo's own sign-in, which its extension reads too | `kilo`, or the extension |
 | Pi | `pi` | AdaptiqAI's package for Pi | `pi --provider adaptiqai --model <id>` |
-| Hermes Agent | `hermes` | AdaptiqAI's plugin, and a custom endpoint of its own | `hermes`, or the app |
-| OpenClaw | `openclaw` | AdaptiqAI's plugin, and the default model | `openclaw dashboard` |
+| Hermes Agent | `hermes` | AdaptiqAI's plugin, turned on, and a custom endpoint of its own; tool search off, as Connect to app sets it | `hermes`, or the app |
+| OpenClaw | `openclaw` | AdaptiqAI's plugin, with its key in OpenClaw's `.env`, and the default model; tool search off, as Connect to app sets it | the app, or `openclaw dashboard` |
 
 ## For agents
 
@@ -38,7 +59,7 @@ object per line, asks nothing, waits for nobody, and never starts or stops an
 app. In a terminal of your own, pass `--json --no-wait`.
 
 ```bash
-npx -y adaptiqai connect cline --json --no-wait
+npx -y adaptiqai connect claude-code --json --no-wait
 ```
 
 Run it, read the last line, and do what it says. The same command goes on from
@@ -47,10 +68,10 @@ wherever the last run ended, so a time limit on your tool cannot lose a sign-in.
 | Exit | Last event | What to do |
 |---|---|---|
 | 3 | `waiting` | Give the person `url` from the `sign_in` event (`say` has the words). Run the command again, with `--wait 90` to wait within your tool's limit. |
-| 4 | `insufficient_balance` | Give the person `add_funds_url`. An empty balance is a state, not a failure: run the command again once they have added a card or funds. |
+| 4 | `insufficient_balance` | Give the person `add_funds_url`. An empty balance is a state, not a failure: run the command again once they have added funds. |
 | 0 | `connected` | Tell the person how to start the app: `start`, and any `notes`. |
-| 1 | `error` | `code` and `message` say why. `app_not_installed` also has `install`. |
-| 2 | `error` or `choose_app` | Not understood. `choose_app` lists the apps found: say which. |
+| 1 | `error` | `code` and `message` say why. `app_not_installed` also has `install`, and `download` for a Mac app; `node_too_old` has `install`, the command that installs a newer Node.js once the person says yes. |
+| 2 | `error` or `choose_app` | Not understood, or no app named: `choose_app` lists every app in `apps` and those on this computer in `installed`. Ask the person which, and run `connect <app>`. |
 
 The person presses Connect and adds funds in their own browser. Nobody else can.
 
@@ -88,8 +109,14 @@ sign in.
   on instead: it may be running inside that very app.
 - **The test request is ephemeral.** It makes no conversation, and costs next
   to nothing.
-- **Compaction** goes off for every model in Cline, Pi, OpenClaw, OpenCode and
-  Kilo, which have no switch for one provider. `disconnect` puts it back. Codex
+- **Claude Code and Codex get the knowledge tools** from AdaptiqAI's MCP
+  server, `@adaptiqai/mcp`, which this installs with npm in
+  `~/.config/adaptiq/mcp`, as Connect to app does. It is installed before the
+  sign-in, so one that cannot be had spends none, and `adaptiq-claude` or
+  Codex's `codex-mcp` brings it up to npm's newest once a day. The folder holds
+  no key.
+- **Compaction** goes off for every model in Pi, OpenClaw, OpenCode and Kilo,
+  which have no switch for one provider. `disconnect` puts it back. Codex
   has no switch at all, so it compacts only once the 5M window is full.
 
 `disconnect` takes the key out of the app. The connection stays listed in the
@@ -102,8 +129,8 @@ browser, and hands the app the approved code.
 
 ## Windows
 
-The command itself, Cline, Codex, Claude Code and Pi are written for Windows,
-and paths, shims and the key file have tests, but it has not been run on Windows
+The command itself, Codex, Claude Code and Pi are written for Windows, and
+paths, shims and the key file have tests, but it has not been run on Windows
 yet. Windows has no `chmod`: a file is as private as your user folder. OpenCode
 and Kilo sign in through `sh`, which Git for Windows brings.