---
title: "codestory"
description: "CodeStory grounding for coding agents over a local managed runtime."
canonical: https://agentpluginsdirectory.com/plugins/codestory
last-updated: 2026-10-02
---

# codestory
CodeStory grounding for coding agents over a local managed runtime.
- Slug: codestory
- Publisher: The Green Cedar
- Repository: https://github.com/TheGreenCedar/CodeStory
- Manifest: plugins/codestory/plugin.json
- Version: 0.17.7
- License: Apache-2.0
- Category (editorial): agent-tooling
- Skills: 1 (codestory-grounding)
- MCP servers: 1 (codestory)
- Stars: 37
- Repository created: 2026-02-05
- Repository last pushed: 2026-10-01
- Publisher type: User
- Listing: https://agentpluginsdirectory.com/plugins/codestory
- Schema: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json

## What codestory does, in the publisher's words

The plugin connects agent hosts to the native CodeStory CLI. It contains no indexing or retrieval implementation of its own: hooks teach routing, the MCP adapter selects a verified CLI, and every live tool request names its repository explicitly.

The portable Agent Plugins v1 core is plugin.json, skills/, and mcp.json. Host manifests add only the rules, hooks, and compatibility wiring their clients require.

The user guide owns shared first-use, platform, privacy, and readiness behavior, including the platform summary. Install steps live on the host pages in the table above.

- scripts/codestory-mcp.cjs is the stdio adapter and managed CLI launcher.
- scripts/cursor-mcp-resolve.cjs locates that launcher for Cursor when the host substitutes the open project for ${PLUGIN_ROOT}, then runs it as the Node main module.

From the project README, punctuation lightly normalized. Full text: https://raw.githubusercontent.com/TheGreenCedar/CodeStory/HEAD/plugins/codestory/README.md

## Skills

- codestory-grounding: Use when an agent should ground a local repository with CodeStory before making source claims, planning edits, choosing tests, reviewing changes, or using broad retrieval evidence through the CodeStory plugin MCP.

Descriptions come from the frontmatter of each SKILL.md, punctuation lightly normalized.

## MCP servers

- codestory: transport: stdio; command: node ${PLUGIN_ROOT}/scripts/codestory-mcp.cjs

Read from the plugin's own mcp.json. Environment variable names only, never values.