feat: add codex agent to cli

Author: gapurov

packages/cli/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @react-grab/cli
 
+## 0.0.71
+
+### Patch Changes
+
+- feat: add Codex agent integration to CLI
+
 ## 0.0.70
 
 ### Patch Changes

packages/cli/README.md

@@ -38,7 +38,7 @@ npx @react-grab/cli -p pnpm -a claude-code -y
 | `--framework` | `-f` | Framework to configure | `next`, `vite`, `webpack` |
 | `--package-manager` | `-p` | Package manager to use | `npm`, `yarn`, `pnpm`, `bun` |
 | `--router` | `-r` | Next.js router type | `app`, `pages` |
-| `--agent` | `-a` | Agent integration to add | `claude-code`, `cursor`, `opencode`, `none` |
+| `--agent` | `-a` | Agent integration to add | `claude-code`, `cursor`, `codex`, `opencode`, `none` |
 | `--yes` | `-y` | Skip all confirmation prompts | - |
 | `--skip-install` | - | Skip package installation (only modify files) | - |
 | `--help` | `-h` | Show help | - |
@@ -56,6 +56,9 @@ npx @react-grab/cli -y
 # Next.js App Router with Cursor agent
 npx @react-grab/cli -f next -r app -a cursor -y
 
+# Next.js App Router with Codex agent
+npx @react-grab/cli -f next -r app -a codex -y
+
 # Vite with Claude Code agent using pnpm
 npx @react-grab/cli -f vite -p pnpm -a claude-code -y
 
@@ -81,6 +84,7 @@ The CLI can optionally set up agent integrations for:
 
 - **Claude Code** (`-a claude-code`) - Send selected elements to Claude Code
 - **Cursor** (`-a cursor`) - Send selected elements to Cursor
+- **Codex** (`-a codex`) - Send selected elements to Codex
 - **Opencode** (`-a opencode`) - Send selected elements to Opencode
 
 ## Manual Installation

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-grab/cli",
-  "version": "0.0.70",
+  "version": "0.0.71",
   "type": "module",
   "bin": {
     "react-grab": "./dist/cli.js"

packages/cli/src/cli.ts

@@ -32,6 +32,7 @@ const PACKAGE_MANAGER_NAMES: Record<PackageManager, string> = {
 const AGENT_NAMES: Record<string, string> = {
   "claude-code": "Claude Code",
   cursor: "Cursor",
+  codex: "Codex",
   opencode: "Opencode",
 };
 
@@ -169,7 +170,7 @@ const parseArgs = async (): Promise<CliArgs> => {
     .option("agent", {
       alias: "a",
       type: "string",
-      choices: ["claude-code", "cursor", "opencode", "none"] as const,
+      choices: ["claude-code", "cursor", "opencode", "codex", "none"] as const,
       description: "Agent integration to automatically forward selected elements to agent instead of copying to clipboard",
     })
     .option("yes", {
@@ -191,12 +192,14 @@ const parseArgs = async (): Promise<CliArgs> => {
     .example("$0 -y", "Auto-detect everything and install without prompts")
     .example("$0 -f next -r app", "Configure for Next.js App Router")
     .example("$0 -a cursor -y", "Add Cursor agent integration non-interactively")
+    .example("$0 -a codex -y", "Add Codex agent integration non-interactively")
     .example("$0 -p pnpm -a claude-code", "Use pnpm and add Claude Code agent")
     .example("$0 --skip-install", "Only modify files, install packages manually")
     .epilog(
       `${pc.bold("Agent Integrations:")}\n` +
         `  ${pc.cyan("claude-code")}  Connect React Grab to Claude Code\n` +
         `  ${pc.cyan("cursor")}       Connect React Grab to Cursor IDE\n` +
+        `  ${pc.cyan("codex")}        Connect React Grab to Codex CLI\n` +
         `  ${pc.cyan("opencode")}     Connect React Grab to Opencode\n\n` +
         `${pc.bold("Supported Frameworks:")}\n` +
         `  ${pc.cyan("next")}     Next.js (App Router & Pages Router)\n` +
@@ -360,6 +363,7 @@ const main = async () => {
     const availableAgents = [
       { name: "Claude Code", value: "claude-code" as const },
       { name: "Cursor", value: "cursor" as const },
+      { name: "Codex", value: "codex" as const },
       { name: "Opencode", value: "opencode" as const },
     ].filter((agent) => !projectInfo.installedAgents.includes(agent.value));
 
@@ -372,7 +376,7 @@ const main = async () => {
       });
     } else {
       const wantAgentIntegration = await confirm({
-        message: "Do you want to add an agent integration (Claude Code, Cursor, or Opencode)?",
+        message: "Do you want to add an agent integration (Claude Code, Cursor, Codex, or Opencode)?",
         default: false,
       });
 

packages/cli/src/detect.ts

@@ -291,7 +291,7 @@ export const detectReactGrab = (projectRoot: string): boolean => {
   return filesToCheck.some(hasReactGrabInFile);
 };
 
-const AGENT_PACKAGES = ["@react-grab/claude-code", "@react-grab/cursor", "@react-grab/opencode"];
+const AGENT_PACKAGES = ["@react-grab/claude-code", "@react-grab/cursor", "@react-grab/opencode", "@react-grab/codex"];
 
 export const detectUnsupportedFramework = (projectRoot: string): UnsupportedFramework => {
   const packageJsonPath = join(projectRoot, "package.json");

packages/cli/src/templates.ts

@@ -1,4 +1,4 @@
-export type AgentIntegration = "claude-code" | "cursor" | "opencode" | "none";
+export type AgentIntegration = "claude-code" | "cursor" | "opencode" | "codex" | "none";
 
 export const NEXT_APP_ROUTER_SCRIPT = `{process.env.NODE_ENV === "development" && (
           <Script

packages/cli/src/transform.ts

@@ -597,6 +597,7 @@ export const transformProject = (
 const AGENT_PREFIXES: Record<string, string> = {
   "claude-code": "npx @react-grab/claude-code@latest &&",
   cursor: "npx @react-grab/cursor@latest &&",
+  codex: "npx @react-grab/codex@latest &&",
   opencode: "npx @react-grab/opencode@latest &&",
 };
 

packages/cli/test/detect.test.ts

@@ -224,13 +224,15 @@ describe("detectInstalledAgents", () => {
         devDependencies: {
           "@react-grab/cursor": "1.0.0",
           "@react-grab/claude-code": "1.0.0",
+          "@react-grab/codex": "1.0.0",
         },
       })
     );
 
     const agents = detectInstalledAgents("/test");
     expect(agents).toContain("cursor");
     expect(agents).toContain("claude-code");
+    expect(agents).toContain("codex");
     expect(agents).not.toContain("opencode");
   });
 

packages/cli/test/install.test.ts

@@ -27,7 +27,7 @@ describe("getPackagesToInstall", () => {
   });
 
   it("should handle all agent types", () => {
-    const agents = ["claude-code", "cursor", "opencode"] as const;
+    const agents = ["claude-code", "cursor", "opencode", "codex"] as const;
 
     for (const agent of agents) {
       const packages = getPackagesToInstall(agent, false);

packages/cli/test/templates.test.ts

@@ -32,7 +32,7 @@ describe("Next.js App Router templates", () => {
   });
 
   it("should include all agent types correctly", () => {
-    const agents = ["claude-code", "cursor", "opencode"] as const;
+    const agents = ["claude-code", "cursor", "opencode", "codex"] as const;
 
     for (const agent of agents) {
       const script = NEXT_APP_ROUTER_SCRIPT_WITH_AGENT(agent);
@@ -54,6 +54,13 @@ describe("Vite templates", () => {
     expect(script).toContain("@react-grab/opencode");
   });
 
+  it("should generate script with codex agent", () => {
+    const script = VITE_SCRIPT_WITH_AGENT("codex");
+
+    expect(script).toContain("react-grab");
+    expect(script).toContain("@react-grab/codex");
+  });
+
   it("should return basic script when agent is none", () => {
     const script = VITE_SCRIPT_WITH_AGENT("none");