@comty.io/core 0.1.2 → 0.1.3

package/README.md

@@ -1,8 +1,6 @@
 # @comty.io/core
 
-Comty's browser SDK and development companion have no npm package dependencies. The Node companion runs the locally installed Codex, Claude or Cursor CLI and stores technical requests in your project's `.comty/tasks.json`.
-
-Requires Node.js 22.12 or newer for the development tools.
+Comty's browser SDK provides shared comments and an element inspector, with no npm package dependencies.
 
 ## Browser SDK
 
@@ -42,47 +40,3 @@ Open inspection with **Shift I**, then select the stopwatch or press **M**. Drag
 Supported: CSS transitions, CSS animations and Web Animations on document timelines, including newly mounted sidebars and open shadow roots (new shadow roots can take up to 500 ms to be discovered). Comty's own interface is excluded. No screen capture, permission prompt, recording buffer, upload or package dependency is involved.
 
 JavaScript animation loops, canvas, closed shadow roots, embedded frames and scroll-driven timelines are not controlled. Application timers and state changes keep their normal timing: a panel removed by a fixed timer can disappear before its slowed animation ends. Comty does not patch global clocks or delay application actions.
-
-## Agent mode with Vite
-
-```js
-// vite.config.js
-import { defineConfig } from 'vite';
-import { comty } from '@comty.io/core/vite';
-
-export default defineConfig({
-  plugins: [comty({ agent: 'codex', model: 'gpt-6-luna' })],
-});
-```
-
-Keep your existing plugins. Run your normal dev command and open `http://localhost:<vite-port>`. The plugin injects the SDK and starts the companion automatically. It is disabled for production builds. The `model` option selects any model supported by your installed Codex CLI; omit it to use your Codex default. Use `agent: 'claude'` or `agent: 'cursor'` to select another provider. A project key is optional in local Agent mode; set `projectKey` and `apiUrl` in the plugin options if you also want shared Comty comments.
-
-## Other development servers
-
-```sh
-npx comty dev --agent codex -- vite --strictPort
-# Next.js:
-npx comty dev --agent claude --target http://127.0.0.1:3000 -- next dev
-```
-
-Open the **Comty URL printed in the terminal** (by default `http://127.0.0.1:4387`). The application continues to run on its own port. HTTP and WebSockets are forwarded to it. `--target` must match that port; use a fixed port so a busy port cannot silently select a different application. The wrapper currently expects uncompressed HTML and buffers HTML responses up to 8 MiB. Prefer the direct Vite plugin when using Vite. Do not use the wrapper and plugin together.
-
-Optional flags: `--port`, `--model` (Codex only), `--project-key`, `--api-url`. Without a command after `--`, the wrapper connects to an already-running local server.
-
-## Using the agent
-
-Install and sign in to your selected coding agent first. Codex and Claude use the project's local CLI when present, otherwise `codex` or `claude` on PATH. Cursor uses `agent` on PATH. Claude's permission requests are relayed to the same Comty sidebar through a local MCP tool. Comty does not provision an AI subscription or credentials.
-
-1. Open the toolbar with Shift S or Shift I.
-2. Select the `</>` Agent tool and click an element.
-3. Describe your change and submit. No Comty account is needed.
-4. Use History in the Code toolbar to show or hide the Local agent sidebar. Review any requested tool permissions there; allow once or deny.
-5. Completed tasks disappear from the page. Their result and verification remain in History. Errors remain visible and can be retried after reviewing partial edits.
-
-Each request starts its own agent session, so tasks can run at the same time in the same project directory. Concurrent agents can touch the same files; review overlapping changes. Cancel stops that task's agent; it does **not** revert changes already made. Requests time out after 30 minutes and remain available for review. Neither normal operation nor shutdown deletes task history.
-
-Comty starts a separate agent session. It does not send instructions into an already-open Codex, Claude or Cursor conversation. Cursor requires a recent Cursor CLI with `agent acp` support; run `agent login` before using it. Legacy `cursor-agent` releases without ACP are unsupported.
-
-Technical requests are never sent to the Comty API or its database. Their prompt and page context are sent to the selected AI provider by its coding agent. Standard shared comments retain their existing Comty authentication and storage.
-
-Add `.comty/` to your application's `.gitignore`. Keep the companion on loopback; LAN binding, tunnels and production hosting are unsupported. Requests require the random token of the running development session and its exact origin.