Skip to content

feat(plugin): Grok skill, SessionStart hook, and MCP with dual-agent docs#202

Merged
badmonster0 merged 8 commits into
cocoindex-io:mainfrom
Roxabi:feat/grok-skill-plugin
Jun 24, 2026
Merged

feat(plugin): Grok skill, SessionStart hook, and MCP with dual-agent docs#202
badmonster0 merged 8 commits into
cocoindex-io:mainfrom
Roxabi:feat/grok-skill-plugin

Conversation

@MickaelV0

@MickaelV0 MickaelV0 commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Document Grok install alongside existing Claude Code plugin marketplace — one .claude-plugin/marketplace.json, same plugin id cocoindex-code, same ccc skill
  • Bundle hooks/hooks.json: SessionStart → incremental ccc index when .cocoindex_code/ exists
  • Bundle .mcp.json: ccc mcp stdio server for semantic search with auto-refresh
  • README covers full install (grok plugin install --trust) and skill-only opt-out (disable hook in /hooks, MCP in /mcps or config.toml)
  • Point plugin manifests at cocoindex-io/cocoindex-code (not a fork)

Test plan

  • grok plugin validate . — skill, hooks, and MCP pass (repo + installed plugin)
  • Review README install paths for Claude Code and Grok — reviewed; Grok install uses cocoindex-io/cocoindex-code shorthand (c7dc723)
  • Confirm hook runs ccc index on session start when index exists — hook command replayed with CLAUDE_PROJECT_DIR + .cocoindex_code/; incremental index, exit 0 (not yet exercised in a live Grok session start)
  • Confirm MCP search tool works via ccc mcp — stdio client: list_toolssearch, hit server.py, success: true

Also validated locally (not required for merge): ccc init / index / search / status / doctor; pytest 231 passed (8 docker_e2e skipped); pre-commit CI green on all matrix jobs.

Out of scope: Grok UI opt-out (/hooks, /mcps), live Claude Code /plugin install, docker_e2e.

MickaelV0 and others added 8 commits May 7, 2026 16:38
Adds `.claude-plugin/marketplace.json` and `.claude-plugin/plugin.json`
so this repo can be installed directly from inside Claude Code:

    /plugin marketplace add cocoindex-io/cocoindex-code
    /plugin install cocoindex-code@cocoindex-code

The existing `skills/ccc/SKILL.md` is auto-discovered as the plugin's
skill — no file moves, the `npx skills add` workflow keeps working
unchanged. README gets a short subsection under "Skill (Recommended)"
linking the new install path.

Refs: https://code.claude.com/docs/en/plugin-marketplaces
Update owner, homepage, repository, and README install command
from cocoindex-io to Roxabi/cocoindex-code.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Document Grok plugin setup (marketplace install + enable) with the same
skill-only pattern as the Claude Code plugin: no bundled hooks or MCP.
Clarify index freshness is agent-driven via the ccc skill, and note
Grok compat MCP disable for users who want CLI/skill search only.

All marketplace and manifest URLs point at cocoindex-io/cocoindex-code.
Add hooks/hooks.json (SessionStart incremental ccc index) and .mcp.json
(ccc mcp stdio). Document full Grok install with --trust and how to
disable hook and MCP for a skill-only setup matching Claude Code.
Add an explicit note that one .claude-plugin/marketplace.json serves both
agents with the same plugin id and skill; Grok activates hooks/MCP via --trust.
Add trailing newlines to plugin JSON manifests (CI end-of-file-fixer).
Document installing via cocoindex-io/cocoindex-code shorthand when the
bare plugin name does not resolve from marketplace.
@badmonster0

Copy link
Copy Markdown
Member

this looks great, thanks @MickaelV0 !

@badmonster0 badmonster0 merged commit d91a12d into cocoindex-io:main Jun 24, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants