projecta-rrr 1.23.3 → 1.23.4

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to RRR will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [1.23.4] - 2026-04-20
+
+### Fixed
+- **Codex hosted MCP launcher** — installer now writes a Codex-specific bearer env file and registers `bearer_token_env_var` in `~/.codex/config.toml` so the hosted RRR setup works with the new `scripts/codex-rrr.sh` launcher.
+- **Codex launch helper** — added `npm run codex:rrr` and docs for starting Codex with the hosted bearer loaded from `~/.config/projecta-rrr/rrr-hosted.env`.
+
 ## [1.23.3] - 2026-04-20
 
 ### Fixed

package/bin/hosted-setup.js

@@ -31,6 +31,8 @@ const HOSTED_URL = 'https://rrr-search-hosted.fly.dev/mcp';
 const GH_APP_INSTALL_URL = 'https://github.com/apps/rrr-search/installations/new';
 const MCP_NAME = 'rrr-search-hosted';
 const CODEX_CONFIG_PATH = path.join(os.homedir(), '.codex', 'config.toml');
+const CODEX_BEARER_ENV_VAR = 'RRR_HOSTED_BEARER';
+const CODEX_ENV_FILE = path.join(os.homedir(), '.config', 'projecta-rrr', 'rrr-hosted.env');
 
 // ──────────────────────────────── UI ──────────────────────────────────────
 
@@ -136,7 +138,7 @@ function registerCodexMcp (bearer) {
   content = content.replace(sectionRegex, '').trimEnd();
 
   // Append new registration
-  const section = `\n\n[mcp_servers.${MCP_NAME}]\nurl = "${HOSTED_URL}"\nheaders = { Authorization = "Bearer ${bearer}" }\n`;
+  const section = `\n\n[mcp_servers.${MCP_NAME}]\nurl = "${HOSTED_URL}"\nbearer_token_env_var = "${CODEX_BEARER_ENV_VAR}"\n`;
   content = content + section;
 
   // Ensure ~/.codex directory exists
@@ -144,6 +146,15 @@ function registerCodexMcp (bearer) {
   fs.writeFileSync(CODEX_CONFIG_PATH, content, 'utf8');
 }
 
+function writeCodexBearerEnv (bearer) {
+  fs.mkdirSync(path.dirname(CODEX_ENV_FILE), { recursive: true });
+  fs.writeFileSync(
+    CODEX_ENV_FILE,
+    `export ${CODEX_BEARER_ENV_VAR}=${JSON.stringify(bearer)}\n`,
+    'utf8'
+  );
+}
+
 // ──────────────────────────────── flow ────────────────────────────────────
 
 async function main () {
@@ -177,7 +188,7 @@ async function main () {
   step(2, TOTAL_STEPS, 'Team bearer token');
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
 
-  let bearer = args.bearer || process.env.RRR_HOSTED_MCP_TOKEN || null;
+  let bearer = args.bearer || process.env.RRR_HOSTED_BEARER || process.env.RRR_HOSTED_MCP_TOKEN || null;
   if (!bearer && !args.yes) {
     info('You need a bearer token of the form: rrr_<prefix>_<32chars>');
     info('New team? Ask your rrr-search admin to run:');
@@ -192,6 +203,9 @@ async function main () {
       err('Bearer format invalid. Expected rrr_<prefix>_<32chars>.');
       process.exit(1);
     }
+    if (!args.bearer && process.env.RRR_HOSTED_MCP_TOKEN && !process.env.RRR_HOSTED_BEARER) {
+      warn('RRR_HOSTED_MCP_TOKEN is deprecated for this launcher; prefer RRR_HOSTED_BEARER.');
+    }
     ok(`Bearer captured (team prefix: ${bearer.split('_')[1]})`);
   } else {
     warn('No bearer — skipping MCP registration. You can run this wizard again after getting one.');
@@ -294,8 +308,11 @@ async function main () {
     }
     try {
       registerCodexMcp(bearer);
+      writeCodexBearerEnv(bearer);
       ok(`Registered ${MCP_NAME} in ~/.codex/config.toml`);
-      info('Same bearer token works for both Claude Code and Codex (MCP-02)');
+      info(`Codex will read the bearer from ${CODEX_BEARER_ENV_VAR}`);
+      info(`Codex launcher env file written to ${CODEX_ENV_FILE}`);
+      info(`Run scripts/codex-rrr.sh to launch Codex with RRR ready`);
     } catch (e) {
       warn(`Could not write ~/.codex/config.toml: ${e.message}`);
       info('You can manually add the MCP server entry — see docs/hosted-search-setup.md');

package/docs/hosted-search-setup.md

@@ -43,6 +43,12 @@ npx projecta-rrr@1.21.0 --enable-hosted
 #    The installer registered `rrr-search-hosted` pointed at https://rrr-search-hosted.fly.dev/mcp.
 ```
 
+For Codex, use `scripts/codex-rrr.sh` to launch the CLI with the hosted bearer loaded from
+`~/.config/projecta-rrr/rrr-hosted.env`. Codex accepts the same `$rrr-*` trigger text, but it
+does not provide Claude-style live autocomplete for those triggers while you type.
+From this repo, `npm run codex:rrr -- <args>` is the shortest way to start Codex with the RRR
+environment loaded.
+
 **What happens under the hood:**
 
 1. The installer writes `rrr-search-hosted` into `~/.claude/mcp.registry.json` with `disabled:false`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projecta-rrr",
-  "version": "1.23.3",
+  "version": "1.23.4",
   "description": "A meta-prompting, context engineering and spec-driven development system for Claude Code by Projecta.ai",
   "bin": {
     "projecta-rrr": "bin/install.js",
@@ -16,6 +16,7 @@
     "test": "node --test tests/*.test.js && jest",
     "test:node": "node --test tests/*.test.js",
     "test:jest": "jest",
+    "codex:rrr": "bash scripts/codex-rrr.sh",
     "test:browser": "vitest --browser",
     "test:ui": "vitest --ui",
     "mcp:setup": "bash scripts/mcp-setup.sh",

package/scripts/codex-rrr.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+ENV_FILE="${RRR_HOSTED_ENV_FILE:-$HOME/.config/projecta-rrr/rrr-hosted.env}"
+
+if [[ -f "$ENV_FILE" ]]; then
+  # shellcheck disable=SC1090
+  source "$ENV_FILE"
+fi
+
+if [[ -z "${RRR_HOSTED_BEARER:-}" ]]; then
+  cat >&2 <<'EOF'
+RRR_HOSTED_BEARER is unset.
+Set it in ~/.config/projecta-rrr/rrr-hosted.env or export it before launching Codex.
+EOF
+  exit 1
+fi
+
+exec codex "$@"