llm-ide-rules 0.5.0__tar.gz → 0.7.0__tar.gz

{llm_ide_rules-0.5.0 → llm_ide_rules-0.7.0}/PKG-INFO

@@ -1,20 +1,24 @@
 Metadata-Version: 2.3
 Name: llm-ide-rules
-Version: 0.5.0
+Version: 0.7.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-Dist: markdown-it-py>=4.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 +26,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 +62,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 +76,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 +115,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.5.0 → llm_ide_rules-0.7.0}/README.md

@@ -1,6 +1,6 @@
 # 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.
 
@@ -8,25 +8,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
@@ -41,7 +44,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
@@ -52,21 +58,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
 
@@ -86,44 +97,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.7.0/pyproject.toml

@@ -0,0 +1,39 @@
+[project]
+name = "llm-ide-rules"
+version = "0.7.0"
+description = "CLI tool for managing LLM IDE prompts and rules"
+keywords = ["llm", "ide", "prompts", "cursor", "copilot"]
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "typer>=0.9.0",
+    "structlog-config>=0.6.0",
+    "requests>=2.25.0",
+    "pydantic>=2.0.0",
+    "json5>=0.9.0",
+    "tomli-w>=1.0.0",
+    "markdown-it-py>=4.0.0",
+]
+authors = [{ name = "Michael Bianco", email = "mike@mikebian.co" }]
+urls = { "Repository" = "https://github.com/iloveitaly/llm-ide-rules" }
+
+# additional packaging information: https://packaging.python.org/en/latest/specifications/core-metadata/#license
+[project.scripts]
+llm-ide-rules = "llm_ide_rules:main"
+
+[build-system]
+requires = ["uv_build>=0.9.0,<0.10.0"]
+build-backend = "uv_build"
+
+# [tool.uv.build-backend]
+# # avoids the src/ directory structure
+# module-root = ""
+
+[dependency-groups]
+dev = ["pytest>=8.3.3", "pyright[nodejs]>=1.1.380", "ruff>=0.8.0", "pytest-mock>=3.10.0"]
+
+[tool.pyright]
+exclude = ["examples/", "playground/", "tmp/", ".venv/", "tests/"]
+
+[tool.ruff]
+extend-exclude = ["playground.py", "playground/"]

llm_ide_rules-0.7.0/src/llm_ide_rules/__init__.py

@@ -0,0 +1,81 @@
+"""LLM Rules CLI package for managing IDE prompts and rules."""
+
+import os
+
+if "LOG_LEVEL" not in os.environ:
+    os.environ["LOG_LEVEL"] = "WARNING"
+
+import typer
+from typing_extensions import Annotated
+
+from llm_ide_rules.commands.explode import explode_main
+from llm_ide_rules.commands.implode import cursor, github, claude, gemini, opencode
+from llm_ide_rules.commands.download import download_main
+from llm_ide_rules.commands.delete import delete_main
+from llm_ide_rules.commands.mcp import mcp_app
+
+__version__ = "0.7.0"
+
+app = typer.Typer(
+    name="llm_ide_rules",
+    help="CLI tool for managing LLM IDE prompts and rules",
+    no_args_is_help=True,
+)
+
+
+@app.callback()
+def main_callback(
+    verbose: Annotated[
+        bool,
+        typer.Option(
+            "--verbose", "-v", help="Enable verbose logging (sets LOG_LEVEL=DEBUG)"
+        ),
+    ] = False,
+):
+    """Global CLI options."""
+    if verbose:
+        os.environ["LOG_LEVEL"] = "DEBUG"
+        import structlog_config
+
+        structlog_config.configure_logger()
+
+
+# Add commands directly
+app.command("explode", help="Convert instruction file to separate rule files")(
+    explode_main
+)
+app.command("download", help="Download LLM instruction files from GitHub repositories")(
+    download_main
+)
+app.command("delete", help="Remove downloaded LLM instruction files")(delete_main)
+
+# Create implode sub-typer
+implode_app = typer.Typer(help="Bundle rule files into a single instruction file")
+implode_app.command(
+    "cursor", help="Bundle Cursor rules and commands into a single file"
+)(cursor)
+implode_app.command(
+    "github", help="Bundle GitHub/Copilot instructions and prompts into a single file"
+)(github)
+implode_app.command("claude", help="Bundle Claude Code commands into a single file")(
+    claude
+)
+implode_app.command("gemini", help="Bundle Gemini CLI commands into a single file")(
+    gemini
+)
+implode_app.command("opencode", help="Bundle OpenCode commands into a single file")(
+    opencode
+)
+app.add_typer(implode_app, name="implode")
+
+# Add MCP configuration management
+app.add_typer(mcp_app, name="mcp")
+
+
+def main():
+    """Main entry point for the CLI."""
+    app()
+
+
+if __name__ == "__main__":
+    main()

{llm_ide_rules-0.5.0 → llm_ide_rules-0.7.0}/src/llm_ide_rules/__main__.py

@@ -3,4 +3,4 @@
 from llm_ide_rules import main
 
 if __name__ == "__main__":
-    main()
+    main()

llm_ide_rules-0.7.0/src/llm_ide_rules/agents/__init__.py

@@ -0,0 +1,28 @@
+"""Agent registry for LLM IDE rules."""
+
+from llm_ide_rules.agents.base import BaseAgent
+from llm_ide_rules.agents.cursor import CursorAgent
+from llm_ide_rules.agents.github import GitHubAgent
+from llm_ide_rules.agents.claude import ClaudeAgent
+from llm_ide_rules.agents.gemini import GeminiAgent
+from llm_ide_rules.agents.opencode import OpenCodeAgent
+
+AGENTS: dict[str, type[BaseAgent]] = {
+    "cursor": CursorAgent,
+    "github": GitHubAgent,
+    "claude": ClaudeAgent,
+    "gemini": GeminiAgent,
+    "opencode": OpenCodeAgent,
+}
+
+
+def get_agent(name: str) -> BaseAgent:
+    """Get an agent instance by name."""
+    if name not in AGENTS:
+        raise ValueError(f"Unknown agent: {name}. Available: {list(AGENTS.keys())}")
+    return AGENTS[name]()
+
+
+def get_all_agents() -> list[BaseAgent]:
+    """Get instances of all registered agents."""
+    return [agent_cls() for agent_cls in AGENTS.values()]