@halfagiraf/clawx 0.1.8 → 0.1.9

package/README.md

@@ -480,16 +480,16 @@ clawx chat -d ./my-project
 
 ## Programmatic usage
 
-```typescript
-import { loadConfig, runAgent, createStreamRenderer } from "@halfagiraf/clawx";
+Use clawx as a library in your own scripts and tools.
 
-const config = loadConfig({
-  provider: "openai-completions",
-  baseUrl: "http://localhost:8080/v1",
-  model: "qwen2.5-coder-14b-instruct",
-});
+**Single task:**
+
+```js
+import { loadConfig, runAgent, createStreamRenderer } from "@halfagiraf/clawx";
 
+const config = loadConfig(); // reads from ~/.clawx/config or .env
 const renderer = createStreamRenderer();
+
 const result = await runAgent(config, {
   prompt: "Create a hello world Express server",
   onEvent: (event) => renderer.onEvent(event),
@@ -497,6 +497,33 @@ const result = await runAgent(config, {
 renderer.finish();
 ```
 
+**Multi-turn with shared context:**
+
+```js
+let messages = [];
+
+for (const prompt of ["Create calc.js with add/subtract", "Add tests"]) {
+  const result = await runAgent(config, { prompt, messages,
+    onEvent: (event) => renderer.onEvent(event),
+  });
+  messages = result.messages; // carry context forward
+}
+```
+
+**Headless for CI/automation:**
+
+```js
+const events = [];
+const result = await runAgent(config, {
+  prompt: "Generate a Dockerfile for this project",
+  onEvent: (event) => events.push(event), // collect instead of printing
+});
+const toolCalls = events.filter(e => e.type === "tool_execution_start");
+console.log(`Done: ${toolCalls.length} tool calls, aborted: ${result.aborted}`);
+```
+
+See [examples/](examples/) for runnable scripts.
+
 ## Troubleshooting
 
 ### TUI launches a file manager instead of the coding agent (Linux)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@halfagiraf/clawx",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Terminal-first coding agent — runs locally with Ollama, DeepSeek, OpenAI, or any OpenAI-compatible endpoint",
   "type": "module",
   "bin": {