Compare commits

...
Author SHA1 Message Date
Ben f44a6a2703 Merge branch 'main' into docs-codex-cloud-first 2026-05-22 09:23:09 -04:00
Ben d0a6dcf770 docs(codex): prioritize Hindsight Cloud over local daemon
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.

Includes 2-line incidental skills/hindsight-docs/ regen drift.
2026-05-21 13:26:59 -04:00
3 changed files with 15 additions and 5 deletions
+5 -1
View File
@@ -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:
@@ -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
+7 -3
View File
@@ -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