@raindrop-ai/pi-agent 0.0.2

package/README.md

@@ -0,0 +1,48 @@
+# @raindrop-ai/pi-agent
+
+Automatic observability for [Pi Agent](https://github.com/badlogic/pi-mono) with [Raindrop](https://raindrop.ai). Captures agent runs, LLM generations, tool calls, and token usage.
+
+Two entry points:
+
+- **`@raindrop-ai/pi-agent`** — programmatic subscriber for `pi-agent-core` users
+- **`@raindrop-ai/pi-agent/extension`** — pi-coding-agent CLI extension (auto-discovered via `pi install`)
+
+## Quick Start — Programmatic
+
+```typescript
+import { Agent } from "@mariozechner/pi-agent-core";
+import { getModel } from "@mariozechner/pi-ai";
+import { createRaindropPiAgent } from "@raindrop-ai/pi-agent";
+
+const raindrop = createRaindropPiAgent({
+  writeKey: "rk_...",
+  userId: "user-123",
+});
+
+const agent = new Agent({
+  initialState: {
+    systemPrompt: "You are a helpful assistant.",
+    model: getModel("openai", "gpt-4o-mini"),
+  },
+});
+
+raindrop.subscribe(agent);
+await agent.prompt("Hello!");
+await raindrop.shutdown();
+```
+
+## Quick Start — Pi Coding Agent CLI
+
+```bash
+pi install npm:@raindrop-ai/pi-agent
+```
+
+Set `RAINDROP_WRITE_KEY` in your environment. Traces appear automatically.
+
+## Documentation
+
+See the full [Pi Agent docs](https://docs.raindrop.ai/sdk/pi-agent) for configuration, per-subscribe overrides, and extension settings.
+
+## License
+
+MIT