# @react-grab/opencode OpenCode agent provider for React Grab. Requires running a local server that interfaces with the OpenCode CLI. ## Installation ```bash npm install @react-grab/opencode # or pnpm add @react-grab/opencode # or bun add @react-grab/opencode # or yarn add @react-grab/opencode ``` ## Server Setup The server runs on port `6567` by default. ### Quick Start (CLI) Start the server in the background before running your dev server: ```bash npx @react-grab/opencode@latest && pnpm run dev ``` The server will run as a detached background process. **Note:** Stopping your dev server (Ctrl+C) won't stop the React Grab server. To stop it: ```bash pkill -f "react-grab.*server" ``` ### Recommended: Config File (Automatic Lifecycle) For better lifecycle management, start the server from your config file. This ensures the server stops when your dev server stops: ### Vite ```ts // vite.config.ts import { startServer } from "@react-grab/opencode/server"; if (process.env.NODE_ENV === "development") { startServer(); } ``` ### Next.js ```ts // next.config.ts import { startServer } from "@react-grab/opencode/server"; if (process.env.NODE_ENV === "development") { startServer(); } ``` > **Note:** You must have [OpenCode](https://opencode.ai) installed (`npm i -g opencode-ai@latest`). ## Client Usage ### Script Tag ```html ``` ### Next.js Using the `Script` component in your `app/layout.tsx`: ```jsx import Script from "next/script"; export default function RootLayout({ children }) { return ( {process.env.NODE_ENV === "development" && ( <>