llm-ide-rules 0.5.0__py3-none-any.whl → 0.6.0__py3-none-any.whl

llm_ide_rules/commands/mcp.py

@@ -0,0 +1,119 @@
+"""
+MCP configuration management commands.
+"""
+
+import json5
+import typer
+from pathlib import Path
+
+from llm_ide_rules.agents import get_agent, get_all_agents
+from llm_ide_rules.mcp import McpConfig
+from llm_ide_rules.log import log
+
+mcp_app = typer.Typer(help="MCP configuration management")
+
+
+@mcp_app.command()
+def explode(
+    input_file: str = typer.Argument("mcp.json", help="Input unified MCP config file"),
+    scope: str = typer.Option(
+        "project", "--scope", "-s", help="Scope: project, global, or both"
+    ),
+    agent: str = typer.Option(
+        "all",
+        "--agent",
+        "-a",
+        help="Agent: claude, cursor, gemini, opencode, copilot, or all",
+    ),
+) -> None:
+    """Convert unified mcp.json to platform-specific configs."""
+    input_path = Path(input_file)
+    if not input_path.exists():
+        log.error("input file not found", file=input_file)
+        raise typer.Exit(1)
+
+    config = McpConfig.model_validate(json5.loads(input_path.read_text()))
+
+    if agent == "all":
+        agents = get_all_agents()
+    else:
+        agents = [get_agent(agent)]
+
+    for ag in agents:
+        if not ag.mcp_project_path:
+            continue
+
+        mcp_project_path = ag.mcp_project_path
+
+        servers = {
+            name: ag.transform_mcp_server(s) for name, s in config.servers.items()
+        }
+
+        if scope in ("project", "both"):
+            project_path = Path.cwd() / mcp_project_path
+            ag.write_mcp_config(servers, project_path)
+            log.info("wrote project config", agent=ag.name, path=str(project_path))
+
+        if scope in ("global", "both") and ag.mcp_global_path:
+            global_path = Path.home() / ag.mcp_global_path
+            ag.write_mcp_config(servers, global_path)
+            log.info("wrote global config", agent=ag.name, path=str(global_path))
+
+
+@mcp_app.command()
+def implode(
+    output_file: str = typer.Argument(
+        "mcp.json", help="Output unified MCP config file"
+    ),
+    source: str = typer.Option(
+        None, "--source", help="Source agent to read from (e.g., claude, cursor)"
+    ),
+    scope: str = typer.Option(
+        "project", "--scope", "-s", help="Scope: project or global"
+    ),
+) -> None:
+    """Merge platform-specific MCP configs into unified mcp.json."""
+    if not source:
+        log.error("source agent must be specified")
+        raise typer.Exit(1)
+
+    ag = get_agent(source)
+
+    if scope == "project":
+        mcp_project_path = ag.mcp_project_path
+        if not mcp_project_path:
+            log.error("project config path not defined for agent", agent=source)
+            raise typer.Exit(1)
+        source_path = Path.cwd() / mcp_project_path
+    else:
+        mcp_global_path = ag.mcp_global_path
+        if not mcp_global_path:
+            log.error("global config path not defined for agent", agent=source)
+            raise typer.Exit(1)
+        source_path = Path.home() / mcp_global_path
+
+    if not source_path.exists():
+        log.error("source config not found", path=str(source_path))
+        raise typer.Exit(1)
+
+    server_configs = ag.read_mcp_config(source_path)
+    if not server_configs:
+        log.error("no MCP servers found in config", path=str(source_path))
+        raise typer.Exit(1)
+
+    servers = {
+        name: ag.reverse_transform_mcp_server(name, config)
+        for name, config in server_configs.items()
+    }
+
+    config = McpConfig(servers=servers)
+    output_path = Path(output_file)
+
+    import json
+
+    output_path.write_text(
+        json.dumps(
+            config.model_dump(exclude_none=True, exclude_defaults=True), indent=2
+        )
+    )
+    log.info("wrote unified config", path=str(output_path))

llm_ide_rules/constants.py

@@ -1,36 +1,39 @@
 """Shared constants for explode and implode functionality."""
 
 import json
-import os
 from pathlib import Path
 
-def load_section_globs(custom_config_path: str = None) -> dict:
+VALID_AGENTS = ["cursor", "github", "claude", "gemini", "opencode", "all"]
+
+
+def load_section_globs(custom_config_path: str | None = None) -> dict[str, str | None]:
     """Load section globs from JSON config file.
-    
+
     Args:
         custom_config_path: Path to custom configuration file to override defaults
-    
+
     Returns:
         Dictionary mapping section headers to their file globs or None for prompts
     """
-    if custom_config_path and os.path.exists(custom_config_path):
+    if custom_config_path and Path(custom_config_path).exists():
         config_path = Path(custom_config_path)
     else:
-        # Load default bundled config
         config_path = Path(__file__).parent / "sections.json"
-    
-    with open(config_path, 'r') as f:
-        config = json.load(f)
-    
+
+    config = json.loads(config_path.read_text())
+
     return config["section_globs"]
 
+
 # Default section globs - loaded from bundled JSON
 SECTION_GLOBS = load_section_globs()
 
-def header_to_filename(header):
+
+def header_to_filename(header: str) -> str:
     """Convert a section header to a filename."""
-    return header.lower().replace(' ', '-')
+    return header.lower().replace(" ", "-")
+
 
-def filename_to_header(filename):
+def filename_to_header(filename: str) -> str:
     """Convert a filename back to a section header."""
-    return filename.replace('-', ' ').title()
+    return filename.replace("-", " ").title()

llm_ide_rules/log.py

@@ -0,0 +1,9 @@
+"""Centralized logging configuration using structlog-config.
+
+This module configures structlog with opinionated defaults and exports a global logger.
+Import the `log` object from this module to use structured logging throughout the application.
+"""
+
+from structlog_config import configure_logger
+
+log = configure_logger()

llm_ide_rules/mcp/__init__.py

@@ -0,0 +1,7 @@
+"""
+MCP configuration management.
+"""
+
+from .models import McpConfig, McpServer
+
+__all__ = ["McpServer", "McpConfig"]

llm_ide_rules/mcp/models.py

@@ -0,0 +1,21 @@
+"""
+Pydantic models for unified MCP configuration.
+"""
+
+from pydantic import BaseModel, Field
+
+
+class McpServer(BaseModel):
+    """Unified MCP server definition."""
+
+    command: str | None = None
+    args: list[str] = Field(default_factory=list)
+    url: str | None = None
+    type: str | None = None
+    env: dict[str, str] | None = None
+
+
+class McpConfig(BaseModel):
+    """Unified mcp.json format."""
+
+    servers: dict[str, McpServer]

llm_ide_rules/sections.json

@@ -1,6 +1,6 @@
 {
   "section_globs": {
-    "Python": "**/*.py",
+    "Python": "**/*.py,pyproject.toml",
     "Python App": "**/*.py",
     "Pytest Integration Tests": "tests/integration/**/*.py",
     "Pytest Tests": "tests/**/*.py",
@@ -9,19 +9,9 @@
     "FastAPI": "app/routes/**/*.py",
     "React": "**/*.tsx",
     "React Router": "web/app/routes/**/*.tsx",
-    "React Router Client Loader": null,
     "Shell": "**/*.sh",
     "TypeScript": "**/*.ts,**/*.tsx",
-    "TypeScript DocString": null,
-    "Secrets": null,
-    "Dev In Browser": null,
-    "Fastapi Stripe": null,
-    "Fix Tests": null,
-    "Implement Fastapi Routes": null,
-    "Plan Only": null,
-    "Python Command": null,
-    "Refactor On Instructions": null,
-    "Standalone Python Scripts": null,
-    "Stripe Backend": null
+    "Secrets": "env/*.sh,.envrc",
+    "Stripe Backend": "manual"
   }
-}
+}

{llm_ide_rules-0.5.0.dist-info → llm_ide_rules-0.6.0.dist-info}/METADATA

@@ -1,20 +1,23 @@
 Metadata-Version: 2.3
 Name: llm-ide-rules
-Version: 0.5.0
+Version: 0.6.0
 Summary: CLI tool for managing LLM IDE prompts and rules
 Keywords: llm,ide,prompts,cursor,copilot
 Author: Michael Bianco
 Author-email: Michael Bianco <mike@mikebian.co>
 Requires-Dist: typer>=0.9.0
-Requires-Dist: structlog>=23.2.0
+Requires-Dist: structlog-config>=0.6.0
 Requires-Dist: requests>=2.25.0
-Requires-Python: >=3.9
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: json5>=0.9.0
+Requires-Dist: tomli-w>=1.0.0
+Requires-Python: >=3.11
 Project-URL: Repository, https://github.com/iloveitaly/llm-ide-rules
 Description-Content-Type: text/markdown
 
 # Copilot, Cursor, Claude, Gemini, etc LLM Instructions
 
-Going to try to centralize all my prompts in a single place and create some scripts to help convert from copilot to cursor, etc.
+This project makes it easy to download prompts and implode/explode them so they can be used by various providers.
 
 I don't want to be tied to a specific IDE and it's a pain to have to edit instructions for various languages across a ton of different files.
 
@@ -22,25 +25,28 @@ Additionally, it becomes challenging to copy these prompts into various projects
 
 Some of the glob assumptions in this repo are specific to how I've chosen to organize python and typescript [in the python starter template](https://github.com/iloveitaly/python-starter-template) and what tooling (fastapi, etc) that I've chosen to use.
 
-## Installation
-
-You can run the `llm-ide-rules` CLI tool using uvx:
+## IDE Format Comparison
 
-```sh
-uvx llm-ide-rules
-```
+Different AI coding assistants use different formats for instructions and commands:
 
-Or install from the repository:
+| IDE | type | folder | Notes |
+|-----|------|--------|-------|
+| **Cursor** | instructions | `.cursor/rules/*.mdc` | Multiple plain markdown files |
+| **Cursor** | commands | `.cursor/commands/*.md` | Plain markdown, no frontmatter |
+| **Claude Code** | instructions | `CLAUDE.md` | Single markdown file at root |
+| **Claude Code** | instructions | `AGENT.md` | Single markdown file at root (agent-specific) |
+| **Claude Code** | commands | `.claude/commands/*.md` | Plain markdown, no frontmatter |
+| **GitHub Copilot** | instructions | `.github/copilot-instructions.md` | Single markdown file |
+| **GitHub Copilot** | instructions | `.github/instructions/*.instructions.md` | Multiple instruction files |
+| **GitHub Copilot** | prompts | `.github/prompts/*.prompt.md` | YAML frontmatter with `mode: 'agent'` |
+| **Gemini CLI** | instructions | `GEMINI.md` | Single markdown file at root |
+| **Gemini CLI** | commands | `.gemini/commands/*.toml` | TOML format, supports `{{args}}` and shell commands |
+| **OpenCode** | commands | `.opencode/commands/*.md` | Plain markdown, no frontmatter |
 
-```sh
-uv tool install git+https://github.com/iloveitaly/llm-ide-rules.git
-```
+## Installation
 
 ```sh
-git clone https://github.com/iloveitaly/llm-ide-rules.git
-cd llm-ide-rules
-uv sync
-source .venv/bin/activate
+uvx llm-ide-rules@latest --help
 ```
 
 ## Usage
@@ -55,7 +61,10 @@ uvx llm-ide-rules explode [input_file]
 
 # Bundle rule files back into a single instruction file
 uvx llm-ide-rules implode cursor [output_file]     # Bundle Cursor rules
-uvx llm-ide-rules implode github [output_file]    # Bundle GitHub/Copilot instructions
+uvx llm-ide-rules implode github [output_file]     # Bundle GitHub/Copilot instructions
+uvx llm-ide-rules implode claude [output_file]     # Bundle Claude Code commands
+uvx llm-ide-rules implode gemini [output_file]     # Bundle Gemini CLI commands
+uvx llm-ide-rules implode opencode [output_file]   # Bundle OpenCode commands
 
 # Download instruction files from repositories
 uvx llm-ide-rules download [instruction_types]    # Download everything by default
@@ -66,21 +75,26 @@ uvx llm-ide-rules download --repo other/repo      # Download from different repo
 uvx llm-ide-rules delete [instruction_types]      # Delete everything by default
 uvx llm-ide-rules delete cursor gemini            # Delete specific types
 uvx llm-ide-rules delete --yes                    # Skip confirmation prompt
-
 ```
 
 ### Examples
 
 ```sh
-# Explode instructions.md into .cursor/rules/ and .github/instructions/
+# Explode instructions.md into all supported formats (cursor, github, claude, gemini, opencode)
 uvx llm-ide-rules explode instructions.md
 
+# Explode for a specific agent only
+uvx llm-ide-rules explode instructions.md --agent opencode
+
 # Bundle Cursor rules back into a single file
 uvx llm-ide-rules implode cursor bundled-instructions.md
 
 # Bundle GitHub instructions with verbose logging
 uvx llm-ide-rules implode github --verbose instructions.md
 
+# Bundle OpenCode commands into commands.md
+uvx llm-ide-rules implode opencode
+
 # Download everything from default repository
 uvx llm-ide-rules download
 
@@ -100,44 +114,6 @@ uvx llm-ide-rules delete cursor gemini --target ./my-project
 uvx llm-ide-rules delete --yes
 ```
 
-### IDE Command Format Comparison
-
-Different AI coding assistants use different formats for commands:
-
-| IDE | Directory | Format | Notes |
-|-----|-----------|--------|-------|
-| **Cursor** | `.cursor/commands/` | `.md` (plain markdown) | Simple, no frontmatter |
-| **Claude Code** | `.claude/commands/` | `.md` (plain markdown) | Simple, no frontmatter |
-| **GitHub Copilot** | `.github/prompts/` | `.prompt.md` (YAML + markdown) | Requires frontmatter with `mode: 'agent'` |
-| **Gemini CLI** | `.gemini/commands/` | `.toml` | Uses TOML format, supports `{{args}}` and shell commands |
-
-## Development
-
-### Using the CLI for Development
-
-The CLI replaces the old standalone scripts. Use the CLI commands in your development workflow:
-
-```shell
-# Setup the environment
-uv sync
-
-# Explode instructions into separate rule files
-uvx llm-ide-rules explode
-
-# Bundle rules back into instructions
-uvx llm-ide-rules implode cursor instructions.md
-```
-
-### Building and Testing
-
-```shell
-# Build the package
-uv build
-
-# Run tests
-pytest
-```
-
 ## Extracting Changes
 
 The idea of this repo is you'll copy prompts into your various projects. Then, if you improve a prompt in a project, you can pull that change into this upstream repo.

llm_ide_rules-0.6.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+llm_ide_rules/__init__.py,sha256=HiB0P4fycSvvJvVeCQYH3WuoJ3jB8NvJV3Cc3k5U2CA,2201
+llm_ide_rules/__main__.py,sha256=8maIDGnEcSUBs9lXg7YEevCXPC0fisYPC2gAEXHfHGM,145
+llm_ide_rules/agents/__init__.py,sha256=-KfKLr_qG26t2OXi1dA-gCesPDqS1ARGa6hELdoyCo0,905
+llm_ide_rules/agents/base.py,sha256=dp7Z3YJtbpQCtEBRdsFedNmljJuqe-C5Vyi8c91vQ2U,8915
+llm_ide_rules/agents/claude.py,sha256=MpdrbhudiD54-EakCb2YPQEKKCd0P2R9c7Gp4umkA2E,2624
+llm_ide_rules/agents/cursor.py,sha256=CDdarb9_SRDmwAVpQWPqX6NoyTyuuWVB_fr-lzxWSGU,5195
+llm_ide_rules/agents/gemini.py,sha256=NnXlOlt4NLzoASjpmNBo079UCGdRR94-2DSC2VxKr7Y,4966
+llm_ide_rules/agents/github.py,sha256=fhM3KpS3TP0LIA0TM6waOuuEsKRsCj3xZRwTetaOImI,6739
+llm_ide_rules/agents/opencode.py,sha256=fNvN91_GCs9b_hFIBhmSdEiky6u7o4Rn5kqQlnj2PXw,3861
+llm_ide_rules/commands/delete.py,sha256=m8hSDD5jruj6QN0w8zuRmrmX-SfscXjuEWwrGy3v0fs,5490
+llm_ide_rules/commands/download.py,sha256=3ipuZwYDKVDtl82Yxyv-VgjFZa8ZCTIxbXGAu0HV6Qc,10792
+llm_ide_rules/commands/explode.py,sha256=M12pXyo5dGKqsgTFWfJC7xNGuXeBqV5ZIp6kHaipjwM,11761
+llm_ide_rules/commands/implode.py,sha256=nVsK3PB9hGYukA7iPEGP5cRwQn3Ma79nC8txf-ES8m8,8161
+llm_ide_rules/commands/mcp.py,sha256=61juJyWe7BQrOisWH67-ynTBe3xjBPGq-s-HAzPWVrU,3680
+llm_ide_rules/constants.py,sha256=2m4yYcWOcLw82P8VF6py7LXDtwfBywOrJK4SHFfyPOY,1163
+llm_ide_rules/log.py,sha256=hfkCLaTf2juQ7n67BYNREUrFxXDh6hqNcN2Pt9YTOo8,322
+llm_ide_rules/mcp/__init__.py,sha256=g73PAMhN7jDqmTBGskWJg2atpPj_-tiVY9ww7YqO2Yw,118
+llm_ide_rules/mcp/models.py,sha256=gYzhgdWQwhH3pmj6OWVFWNNKRgxcblXeE3car2Tv8O4,440
+llm_ide_rules/sections.json,sha256=fY5dY7hIMfHAiLT7OHMj-_iV83LYv5-BL6o9iOXSmOE,536
+llm_ide_rules-0.6.0.dist-info/WHEEL,sha256=XV0cjMrO7zXhVAIyyc8aFf1VjZ33Fen4IiJk5zFlC3g,80
+llm_ide_rules-0.6.0.dist-info/entry_points.txt,sha256=xsALXWBwSEifz-2Mike7s2SwqNu1taLs_-EcmGrONeM,54
+llm_ide_rules-0.6.0.dist-info/METADATA,sha256=WHPO5PBdkCh1g6diZjOBmDzTGnsI8P621LUvCuJbxTk,5318
+llm_ide_rules-0.6.0.dist-info/RECORD,,

{llm_ide_rules-0.5.0.dist-info → llm_ide_rules-0.6.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.8.11
+Generator: uv 0.9.26
 Root-Is-Purelib: true
-Tag: py3-none-any
+Tag: py3-none-any

llm_ide_rules-0.5.0.dist-info/RECORD

@@ -1,12 +0,0 @@
-llm_ide_rules/__init__.py,sha256=494c58df084291e4e427a1a36f78306224ea83305531dcff5c566c2fb53e16ce,1472
-llm_ide_rules/__main__.py,sha256=881447dbad0fe837590fa8224f1d0dd70416fd5344779978d07744ff8e0cf868,144
-llm_ide_rules/commands/delete.py,sha256=6ed0a44b1be1d950180831681d79e3a0be91cd37296e30e7a0d821d49292ebf4,5812
-llm_ide_rules/commands/download.py,sha256=06c2a841db5fe0b0f7f3e8c99ad198c8e07e53d8801fb4d95e802ecee60cda31,11022
-llm_ide_rules/commands/explode.py,sha256=59df4bb542397c9204332ba563a95c49d236a82ebc6af81378b2798f8adc2e77,14779
-llm_ide_rules/commands/implode.py,sha256=f3e9ff754530c06d7eacb20fc37ae8d958218f02df2a0f48eac1d5c6a9a749be,16743
-llm_ide_rules/constants.py,sha256=1182b9757ca58d038a4878d1b55570aac4f0287f1a5ab5af8d68331b799b0686,1118
-llm_ide_rules/sections.json,sha256=e82bf37f8a7bd919c881d7cc084cdfd82e1f9e6ff5385c74b18c14996bcac3c1,822
-llm_ide_rules-0.5.0.dist-info/WHEEL,sha256=0f7d664a881437bddec71c703c3c2f01fd13581519f95130abcc96e296ef0426,79
-llm_ide_rules-0.5.0.dist-info/entry_points.txt,sha256=c6c00b5d607048489fcfed8c8a47bbb364b0a8dbb5b5a2ecffe11c986ace35e3,54
-llm_ide_rules-0.5.0.dist-info/METADATA,sha256=af671c42110d55d0670a3aef9007b890dcb5d6335add807d36d8baadf3e802a3,4898
-llm_ide_rules-0.5.0.dist-info/RECORD,,