docs: document recent package updates

AGENTS.md

@@ -12,7 +12,7 @@ When adding a new provider, the author should be creating 1 provider file, every
 
 We are not doing branches unless requested. Everything happens on main and we push straight to main (when requested).
 
-ALWAYS monitor the build after push until the release is successful. 
+ALWAYS monitor the build after push until the release is successful.
 
 ## Bad habits that I want to avoid
 

README.md

@@ -80,8 +80,11 @@ Utilities are especially useful for scripting and CI/CD.
 
 ```bash
 npx poe-code@latest spawn codex "Say hello"
+npx poe-code@latest spawn cursor "Say hello from Cursor"
 ```
 
+Cursor spawns use the authenticated `cursor-agent` installation and your Cursor account; Poe Code does not inject Poe credentials into Cursor.
+
 #### Spawn against a GitHub repository
 
 ```bash
@@ -121,6 +124,9 @@ npx poe-code@latest install codex
 # OpenCode
 npx poe-code@latest install opencode
 
+# Cursor
+npx poe-code@latest install cursor
+
 # Kimi
 npx poe-code@latest install kimi
 
@@ -249,12 +255,15 @@ console.log(run.output);
 
 Runs a single prompt through a configured service CLI.
 
-- `service` – Service identifier (`claude-code`, `codex`, `opencode`, `kimi`, `goose`)
+- `service` – Service identifier (`claude-code`, `codex`, `cursor`, `opencode`, `kimi`, `goose`)
 - `options.prompt` – The prompt to send
 - `options.cwd` – Working directory or workspace locator (optional). Supports local paths and `github://owner/repo[#ref[:subdir]]` locators. See [@poe-code/workspace-resolver](packages/workspace-resolver/) for the full locator syntax.
 - `options.model` – Model identifier override (optional)
 - `options.mode` – Permission mode: `yolo`, `edit`, or `read` (optional)
 - `options.args` – Additional arguments forwarded to the CLI (optional)
+- `options.env` – Per-invocation child environment overrides (optional)
+- `options.mcpServers` – Spawn-time MCP servers serialized into the agent-specific flags or environment (optional)
+- `options.runtime`, `options.runtimeImage`, `options.runtimeTemplate`, `options.detach`, `options.mountPoeCode`, `options.runnerSync` – Runtime overrides for agents with CLI spawn support (optional). ACP-only agents reject these options instead of running locally.
 
 Returns `{ stdout, stderr, exitCode }`.
 
@@ -263,10 +272,10 @@ Returns `{ stdout, stderr, exitCode }`.
 Same as `spawn()`, but renders the ACP event stream to stdout with colored, formatted output — matching the CLI's visual style.
 
 ```typescript
-import { spawn } from "poe-code"
+import { spawn } from "poe-code";
 
-const result = await spawn.pretty("codex", "Fix the bug in auth.ts")
-console.log(result.exitCode)
+const result = await spawn.pretty("codex", "Fix the bug in auth.ts");
+console.log(result.exitCode);
 ```
 
 Returns `Promise<{ stdout, stderr, exitCode }>`.