docs: add agent integration roadmap to README#344
Open
aidenybai wants to merge 1 commit into
Open
Conversation
Co-Authored-By: Aiden Bai <aiden.bai05@gmail.com>
Contributor
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
commit: |
![vercel[bot]](https://avatars.githubusercontent.com/in/8329?s=60&v=4){kind=small}
| grab latest # latest grab as JSON (reads .react-grab/ or falls back to clipboard) | ||
| grab context # latest grab as formatted markdown | ||
| grab log # stream grabs as NDJSON (runs until killed) | ||
| grab history # list past grabs from .react-grab/grabs/ |
Contributor
There was a problem hiding this comment.
README documents CLI commands (grab watch, grab latest, grab context, grab log, grab history) that are not implemented in the codebase
![cubic-dev-ai[bot]](https://avatars.githubusercontent.com/in/1082092?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
1 issue found across 1 file
Prompt for AI agents (unresolved issues)
Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.
<file name="README.md">
<violation number="1" location="README.md:239">
P2: Don't present the Cursor/Claude adapter examples as current commands yet; the CLI is still MCP-only, so these examples will fail if users copy them.</violation>
</file>
Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.
| `grab add` detects your agent and installs the right integration format: | ||
|
|
||
| ```bash | ||
| grab add # interactive: pick agents |
Contributor
There was a problem hiding this comment.
P2: Don't present the Cursor/Claude adapter examples as current commands yet; the CLI is still MCP-only, so these examples will fail if users copy them.
Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At README.md, line 239:
<comment>Don't present the Cursor/Claude adapter examples as current commands yet; the CLI is still MCP-only, so these examples will fail if users copy them.</comment>
<file context>
@@ -190,6 +190,57 @@ actions: [
+`grab add` detects your agent and installs the right integration format:
+
+```bash
+grab add # interactive: pick agents
+grab add cursor # Cursor-specific integration
+grab add claude # Claude Code-specific integration
</file context>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds an "Agent Integration" section to the README documenting the planned layered architecture for connecting React Grab to coding agents.
The four layers:
grab watchmaintains.react-grab/context.md— agents that auto-index project files discover it automatically.grab latest,grab context,grab log,grab history— composable commands for skills and scripts..react-grab/hooks/on-grabexecutables, completely agent-agnostic.Also documents per-agent setup via
grab add <agent>.This is a docs-only change describing the planned direction. No code changes.
Review & Testing Checklist for Human
grab watch,grab latest,grab context,grab history) feel right before they get implementedgrab add cursor,grab add claude) matches the direction you want for Phase 3Notes
See the full implementation plan (brainstorm + phases) shared earlier in the session. This README change is the user-facing version of that plan. The implementation phases (filesystem persistence → hooks → agent adapters → simplified skill → kill MCP) are designed to ship independently.
Link to Devin session: https://app.devin.ai/sessions/272b3ae291454c63ad621b1acb6db231
Requested by: @aidenybai
Note
Low Risk
Low risk docs-only change; no runtime behavior or APIs are modified, but it does introduce CLI and filesystem concepts that should match the intended product direction.
Overview
Adds a new "Agent Integration" section to
README.mdthat outlines a four-layer roadmap for using React Grab with coding agents: direct paste, a watched.react-grab/context.mdfile (plus grab journal), CLI primitives (grab latest/context/log/history), and hook-style executables under.react-grab/hooks/on-grab.Also documents per-agent installation flow via
grab add(includingcursorandclaude) to set expectations for future integrations.Reviewed by Cursor Bugbot for commit 7e33164. Bugbot is set up for automated code reviews on this repo. Configure here.
Summary by cubic
Add an Agent Integration section to the README that outlines a layered plan for connecting
react-grabto coding agents. It documents Layers 0–3 (Paste; Context File viagrab watchand.react-grab/context.md; CLI commandsgrab latest,grab context,grab log,grab history; and hooks with.react-grab/hooks/on-grab) and per‑agent setup withgrab add <agent>; docs-only.Written for commit 7e33164. Summary will update on new commits.