Merge branch 'main' into docs-agentcore-cloud-first

docs(codex): prioritize Hindsight Cloud over local daemon (#1693 )
Add Cloud Recommended callouts to README + docs + guide. Reframe the 'Local Daemon' section as the self-hosting alternative rather than a peer option. No code default changes — codex still defaults to empty hindsightApiUrl (local daemon) to avoid breaking existing local users.
2026-05-22 09:32:05 -04:00 · 2026-05-22 09:31:43 -04:00 · 2026-05-21 13:28:37 -04:00
6 changed files with 25 additions and 5 deletions
@@ -40,6 +40,10 @@ pip install hindsight-agentcore

 ## Quick Start

+:::tip Recommended: Hindsight Cloud
+[Sign up free](https://ui.hindsight.vectorize.io/signup) and grab an API key — no self-hosting required.
+:::
+
 ```python
 import os
 from hindsight_agentcore import HindsightRuntimeAdapter, TurnContext, configure
@@ -12,11 +12,15 @@ Persistent memory for [Codex CLI](https://github.com/openai/codex) using [Hindsi

 ## Quick Start

+:::tip Recommended: Hindsight Cloud
+[Sign up free](https://ui.hindsight.vectorize.io/signup) for a Hindsight Cloud API key — no self-hosting, no local daemon to manage.
+:::
+
 ```bash
 curl -fsSL https://hindsight.vectorize.io/get-codex | bash
 ```

-The installer will guide you through choosing local or cloud mode and configuring your connection. Once installed, start a new Codex session — memory is live.
+The installer will guide you through choosing Cloud or local-daemon mode and configuring your connection. Once installed, start a new Codex session — memory is live.

 To uninstall:

@@ -44,6 +44,8 @@ pip install hindsight-agentcore

 ## Step 2: Connect AgentCore Runtime to Hindsight

+> ✨ **Recommended:** [Hindsight Cloud](https://ui.hindsight.vectorize.io/signup) — free tier, no self-hosting required.
+
 ```python
 import os
 from hindsight_agentcore import configure
@@ -54,6 +56,8 @@ configure(
 )
 ```

+If you'd rather self-host on AWS (ECS/EKS with RDS PostgreSQL + pgvector), set `hindsight_api_url` to your in-VPC Hindsight endpoint.
+
 ## Step 3: Wire memory into your runtime

 ```python
@@ -46,6 +46,8 @@ The installer places the hook scripts under `~/.hindsight/codex/scripts/`, write

 ## Step 2: Connect Codex CLI to Hindsight

+> ✨ **Recommended:** [Hindsight Cloud](https://ui.hindsight.vectorize.io/signup) — free tier, no self-hosting required.
+
 ```json
 {
  "hindsightApiUrl": "https://api.hindsight.vectorize.io",
@@ -54,7 +56,7 @@ The installer places the hook scripts under `~/.hindsight/codex/scripts/`, write
 }
 ```

-Save that as `~/.hindsight/codex.json`. For local daemon mode, you can leave `hindsightApiUrl` empty and export a provider key before starting Codex:
+Save that as `~/.hindsight/codex.json`. If you'd rather self-host with the local daemon (`hindsight-embed`), leave `hindsightApiUrl` empty and export a provider key before starting Codex:

 ```bash
 export OPENAI_API_KEY=sk-your-key
@@ -34,6 +34,8 @@ pip install hindsight-agentcore

 ## Quick Start

+> ✨ **Recommended: [Hindsight Cloud](https://ui.hindsight.vectorize.io/signup)** — free tier, no self-hosting required. Sign up and grab an API key in under a minute.
+
 ```python
 import os
 from hindsight_agentcore import HindsightRuntimeAdapter, TurnContext, configure
@@ -20,6 +20,8 @@ Three Codex hooks keep memory in sync automatically:

 ## Installation

+> ✨ **Recommended: [Hindsight Cloud](https://ui.hindsight.vectorize.io/signup)** — free tier, no self-hosting required. Skip the local daemon entirely.
+
 ```bash
 curl -fsSL https://hindsight.vectorize.io/get-codex | bash
 ```
@@ -49,7 +51,9 @@ For personal overrides (stable across updates), create `~/.hindsight/codex.json`
 }
 ```

-### Hindsight Cloud
+### Hindsight Cloud (recommended)
+
+> ✨ Sign up free at [Hindsight Cloud](https://ui.hindsight.vectorize.io/signup) — no self-hosting, no LLM API key, no daemon to manage.

 ```json
 {
@@ -58,9 +62,9 @@ For personal overrides (stable across updates), create `~/.hindsight/codex.json`
 }
 ```

-### Local daemon (hindsight-embed)
+### Self-hosting: local daemon (`hindsight-embed`)

-Set an LLM API key and Hindsight will start the local server automatically:
+If you'd rather run Hindsight locally, leave `hindsightApiUrl` empty and set an LLM API key — Hindsight will start the local server automatically:

 ```bash
 export OPENAI_API_KEY=sk-your-key