@grepr/cli 1.12.6-f4cc8d6 → 1.12.7

package/build/dist/docs-index/{ac954b57-993a-4736-bef5-49c36ca0af3c.txt → cf1135f6-082f-4cc4-ba07-1b1aed67127d.txt}

@@ -51,4 +51,4 @@ Parameters for a logs backfill.
 
 - name: vendorSinkIntegrationIds (optional)
   type: array of string
-  description: Vendor integration IDs, if any, whose prior delivery the backfill skips. Also gates concurrent overlapping backfills. Empty (the default) does no per-vendor dedup join and never blocks on other backfills.
+  description: Vendor integration IDs, if any, whose prior delivery the backfill skips: exactly the integrations the sinks send to, or empty. Also gates concurrent overlapping backfills. Empty (the default) does no per-vendor dedup join and never blocks on other backfills.

package/build/dist/docs-index/{e7fe8b3a-330a-4194-831c-0db07f98cab1.txt → e736d9b2-36e8-47b2-bb93-ba9b49236275.txt}

@@ -16,7 +16,7 @@ Files a new issue. Creating never deduplicates: search first, and update or reco
 
 - name: entities (optional)
   type: object
-  description: The `entity:*` tags it concerns; an unprefixed key is put in the `entity:` namespace.
+  description: The `entity:*` tags it concerns; an unprefixed key is put in the `entity:` namespace. Keys are stored in lower case, and values as given; searches match both in any case.
 
 - name: evidence (optional)
   type: array of `IssueEvidence`

package/build/dist/docs-index/{fe47c52c-409f-4888-a262-b00d7110352b.txt → f1506aaf-90bc-4b49-b316-871ebb742c3f.txt}

@@ -31,6 +31,9 @@ Get the list of jobs for your organization based on filters.
 - **id** (optional) - query
   - Optional filter to fetch specific jobs by id
   - Type: array of string
+- **tag** (optional) - query
+  - Optional filter to fetch only jobs carrying every given tag, each as key:value
+  - Type: array of string
 
 ## Responses
 

package/build/dist/docs-index/{c5c05492-c472-413f-83f4-02aaef63cc5f.txt → f248f67a-962b-4f90-8231-8f67d9061551.txt}

@@ -122,6 +122,8 @@ The webhook mapping reads the service and host from field names Grepr expects. I
 
 Consistent tag values matter more than complete ones. A service tagged `checkout` in some memories and `checkout-svc` in others splits its history in two, and a timeline search finds only half. An agent can ask a search for the tag values already in use in your organization, so an agent that checks before recording reuses existing values rather than inventing new ones.
 
+Case doesn't split a history: `Service=Checkout` and `service=checkout` are the same tag.
+
 ## Set how an agent uses its memory \[#policy]
 
 The **Retrieval policy** settings on the agent's **Memories** step tell the agent how much to search and what to record. Grepr adds them to the agent's instructions, so you do not restate them in the agent's own prompt.

package/build/dist/docs-index/fdbc60a1-e886-4bbd-af07-efb38debeb70.txt

@@ -0,0 +1,39 @@
+# BackfillProgress
+
+What a logs backfill is doing, and how far it is.
+
+**Type**: `object`
+
+## Properties
+
+- name: bytesScanned (optional)
+  type: integer
+  description: The bytes the backfill's current query has scanned.
+
+- name: eventsDelivered (optional)
+  type: object
+  description: The events each vendor confirmed receiving, by vendor integration id.
+
+- name: eventsRead (optional)
+  type: integer
+  description: The events read so far.
+
+- name: eventsTotal (optional)
+  type: integer
+  description: The events selected to send, once they are. A vendor can receive fewer, since events it already has are skipped.
+
+- name: failureReason (optional)
+  type: string
+  description: Why the backfill failed, when it did.
+
+- name: phase (required)
+  type: enum: `PENDING`, `WAITING`, `STARTING`, `FINDING_CUTOFF`, `EXPORTING`, `SENDING`, `NOTHING_TO_SEND`, `FINISHED`, `FAILED`, `CANCELLED`, `DELETED`
+  description: What the backfill is doing.
+
+- name: selectingMillis (optional)
+  type: integer
+  description: How long the backfill's current query has queued and run.
+
+- name: waitingReason (optional)
+  type: string
+  description: Why the backfill is waiting, when it is.

package/build/dist/docs-index/{cf6f1f55-4cf7-4e28-a4c7-f937395ea6cb.txt → fe7b90fb-df65-470b-90f9-33666add9bbe.txt}

@@ -1,4 +1,4 @@
-Connect Claude or Claude Code to the Grepr MCP server with OAuth sign-in, or connect any MCP client with a service account access token.
+Connect Claude, Claude Code, Cursor, Codex, or ChatGPT to the Grepr MCP server with OAuth sign-in, or connect any MCP client with a service account token.
 
 # Connect to the Grepr MCP server
 
@@ -15,7 +15,7 @@ The examples on this page use the US endpoint. If your organization is in the EU
 
 You can authenticate in two ways:
 
-* OAuth sign-in: You sign in interactively with your Grepr user account. Use this for Claude and Claude Code.
+* OAuth sign-in: You sign in interactively with your Grepr user account. Use this for Claude, Claude Code, Cursor, Codex, and ChatGPT.
 * Service account credentials: Your client authenticates as a Grepr service account. Use this for Claude Tag in Slack, for automation, and for MCP clients that do not support the OAuth sign-in flow.
 
 ## Sign in with OAuth
@@ -26,6 +26,9 @@ Grepr registers a dedicated OAuth client for each supported MCP client. To conne
 | --- | --- | --- |
 | Claude | `us3sBOgZj6hERktG9yZEVwujaJe3j9L0` | `HOnxCPNGnzdGlfXBM2sff0twoolRnDj9` |
 | Claude Code | `jlCTdLYzDkkTSc2I7MdI0SBw48AOdJM6` | `GlEIcfSbge5gqN4o918fLXKVONP2twBh` |
+| Cursor | `ol2iI3MgbY4gDMT1SbCDQHj5OA8K4bAg` | `XHHImmxqr9EihBqVOettpLhS6CxDBhoB` |
+| Codex | `QPTtqmepPCvjvAs4rJHfBwXC4HklKefA` | `V0JSLGp1GmySuCj8tJPGqTXXMuP6unRx` |
+| ChatGPT | `R3rgytuEh03CzvNrasYj8R3eeAaYVcAP` | `7GCueSSV94VNsv2TkLGnWiWlyoS3DQrA` |
 
 ### Claude
 
@@ -48,6 +51,60 @@ The `--callback-port 6280` flag is required. Without it, Claude Code picks a ran
 
 Then open Claude Code, run `/mcp`, select `grepr`, and complete the sign-in flow in your browser with your Grepr user account.
 
+### Cursor
+
+Add the server with the Grepr client ID to `~/.cursor/mcp.json`, or to `.cursor/mcp.json` in a project:
+
+```json
+{
+  "mcpServers": {
+    "grepr": {
+      "url": "https://app.grepr.ai/mcp",
+      "auth": {
+        "CLIENT_ID": "ol2iI3MgbY4gDMT1SbCDQHj5OA8K4bAg"
+      }
+    }
+  }
+}
+```
+
+The `auth` block with `CLIENT_ID` is required. Without it, Cursor tries dynamic client registration, which Grepr does not support, and the sign-in fails. Do not add a client secret. Cursor uses fixed callback URLs that Grepr registers, so you do not need to set a callback port.
+
+Save the file and restart Cursor. The `grepr` server shows in **Customize** > **MCPs**. When Cursor prompts you to sign in, complete the sign-in flow in your browser with your Grepr user account.
+
+### Codex
+
+Add the server with the Grepr client ID and the fixed callback port to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.grepr]
+url = "https://app.grepr.ai/mcp"
+
+[mcp_servers.grepr.oauth]
+client_id = "QPTtqmepPCvjvAs4rJHfBwXC4HklKefA"
+callback_port = 6280
+```
+
+The `callback_port = 6280` setting is required. Without it, Codex picks a random port and the sign-in fails with a callback URL mismatch. Use the endpoint for your region exactly as the endpoint table writes it, with no trailing slash, because Codex builds its callback URL from the endpoint URL.
+
+Then sign in:
+
+```bash
+codex mcp login grepr
+```
+
+Complete the sign-in flow in your browser with your Grepr user account.
+
+### ChatGPT
+
+Your ChatGPT plan or workspace settings must allow custom MCP servers.
+
+1. In ChatGPT, go to **Plugins**, click **Add**, and select **Add custom MCP server**.
+2. Enter a name such as `Grepr`, and enter `https://app.grepr.ai/mcp` as the **Server URL**. Enter the endpoint for your region exactly as the endpoint table writes it, because ChatGPT builds its callback URL from it. Keep **OAuth** as the **Authentication**.
+3. Open **Advanced OAuth settings** and keep **User-Defined OAuth Client** as the **Registration method**. Enter `R3rgytuEh03CzvNrasYj8R3eeAaYVcAP` as the **OAuth client ID**, leave the client secret empty, and keep `none` as the **Token endpoint auth method**.
+4. Select **I understand and want to continue** and click **Create as a plugin**.
+5. When ChatGPT prompts you to sign in, complete the sign-in flow with your Grepr user account.
+
 ## Connect Claude Tag in Slack
 
 Claude Tag is Claude in Slack channels. In a channel, Claude acts as a shared identity that an Owner of your Claude organization configures, not as the person who sends the message. Everyone in a channel that the configuration covers gets the same Grepr access, so connect a dedicated Grepr service account with the narrowest role that fits the channel. Direct messages with Claude in Slack run on your own Claude account and use the Claude connector described earlier on this page.
@@ -143,9 +200,21 @@ The MCP endpoint is https\://app.grepr.ai/mcp for the US region and https\://app
 
 Add a custom connector in Claude with the URL https\://app.grepr.ai/mcp, and enter the Grepr client ID for Claude under Advanced settings. Then sign in with your Grepr user account.
 
+### How do I connect Cursor to Grepr?
+
+Add the server to your Cursor mcp.json file with the URL https\://app.grepr.ai/mcp and an auth block that contains the Grepr client ID for Cursor. Then restart Cursor and, when it prompts you, sign in with your Grepr user account.
+
+### How do I connect Codex to Grepr?
+
+Add the server to your Codex config.toml file with the URL https\://app.grepr.ai/mcp, the Grepr client ID for Codex, and callback_port = 6280. Then run codex mcp login grepr and sign in with your Grepr user account.
+
+### How do I connect ChatGPT to Grepr?
+
+Add a custom MCP server in ChatGPT with the URL https\://app.grepr.ai/mcp and OAuth authentication. Under Advanced OAuth settings, keep User-Defined OAuth Client as the registration method and enter the Grepr client ID for ChatGPT. Then sign in with your Grepr user account.
+
 ### Why does the MCP sign-in fail with a callback URL mismatch?
 
-Grepr registers exact OAuth callback URLs. Clients that open the sign-in flow on a local port must use port 6280, for example with the --callback-port 6280 flag in Claude Code.
+Grepr registers exact OAuth callback URLs. Claude Code and Codex must use port 6280. In Claude Code, set it with the --callback-port 6280 flag. In Codex, set callback_port = 6280 in config.toml. Cursor and ChatGPT use callback URLs that Grepr registers, so they need no callback setting. Codex and ChatGPT build the callback URL from the server URL, so enter the endpoint for your region exactly as the endpoint table writes it.
 
 ### Can I use the Grepr MCP server without OAuth?
 

package/build/dist/docs-index/ff5891aa-d054-4e00-90a3-ce9d45f486dc.json

@@ -0,0 +1 @@
+{"docType":"schema"}

package/build/dist/docs-index/ffa49cd7-774f-40c3-aa82-1565e85922c5.json

@@ -0,0 +1 @@
+{"docType":"api"}