docs: update all documentation for subscription auth, billing tiers, and API key management

README.md

@@ -18,6 +18,15 @@
 
 Existing observability tools show you _what_ LLM calls were made. AgentLens shows you _why_ your agent made each decision along the way -- which tool it picked, what alternatives it rejected, and the reasoning behind every choice.
 
+## Getting Started
+
+1. **Register** at [agentlens.vectry.tech/register](https://agentlens.vectry.tech/register) with your email and password.
+2. **Log in** to the dashboard at [agentlens.vectry.tech](https://agentlens.vectry.tech).
+3. **Create an API key** in **Settings > API Keys**.
+4. **Install the SDK** and start tracing.
+
+> Self-hosting? You do not need to register with the hosted service. See [Self-Hosting](#self-hosting) below.
+
 ## Quick Start
 
 ```bash
@@ -27,6 +36,7 @@ pip install vectry-agentlens
 ```python
 import agentlens
 
+# Use the API key you created in Settings > API Keys
 agentlens.init(api_key="your-key", endpoint="https://agentlens.vectry.tech")
 
 with agentlens.trace("my-agent-task", tags=["production"]):
@@ -41,7 +51,7 @@ with agentlens.trace("my-agent-task", tags=["production"]):
 agentlens.shutdown()
 ```
 
-Open `https://agentlens.vectry.tech/dashboard` to see your traces.
+Open `https://agentlens.vectry.tech/dashboard` to see your traces (login required).
 
 ## Features
 
@@ -72,7 +82,7 @@ Add to your `opencode.json`:
 }
 ```
 
-Set environment variables:
+Set environment variables (use the API key from your dashboard at **Settings > API Keys**):
 
 ```bash
 export AGENTLENS_API_KEY="your-key"
@@ -90,6 +100,7 @@ npm install agentlens-sdk
 ```typescript
 import { init, TraceBuilder, SpanType, SpanStatus } from "agentlens-sdk";
 
+// Use the API key from Settings > API Keys in your dashboard
 init({ apiKey: "your-key", endpoint: "https://agentlens.vectry.tech" });
 
 const trace = new TraceBuilder("my-agent-task", {
@@ -173,8 +184,24 @@ with agentlens.trace("planner"):
 | `MEMORY_RETRIEVAL` | Agent chose what context to retrieve |
 | `CUSTOM` | Any other decision type |
 
+## Pricing
+
+AgentLens cloud ([agentlens.vectry.tech](https://agentlens.vectry.tech)) offers three billing tiers. One trace equals one session for billing purposes.
+
+| Plan | Price | Sessions | Details |
+|------|-------|----------|---------|
+| **Free** | $0 | 20 sessions/day | No credit card required |
+| **Starter** | $5/month | 1,000 sessions/month | For individual developers |
+| **Pro** | $20/month | 100,000 sessions/month | For teams and production workloads |
+
+Manage your subscription in **Settings > Billing** in the dashboard.
+
+Self-hosted instances are not subject to these limits.
+
 ## Self-Hosting
 
+Self-hosted AgentLens instances do not require registration with the hosted SaaS service. You manage your own API keys and have no session limits.
+
 ```bash
 git clone https://gitea.repi.fun/repi/agentlens.git
 cd agentlens