llm-ide-rules 0.2.1__tar.gz → 0.4.0__tar.gz

{llm_ide_rules-0.2.1 → llm_ide_rules-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: llm-ide-rules
-Version: 0.2.1
+Version: 0.4.0
 Summary: CLI tool for managing LLM IDE prompts and rules
 Keywords: llm,ide,prompts,cursor,copilot
 Author: Michael Bianco
@@ -12,7 +12,7 @@ Requires-Python: >=3.9
 Project-URL: Repository, https://github.com/iloveitaly/llm-ide-rules
 Description-Content-Type: text/markdown
 
-# Copilot & Cursor LLM Instructions
+# 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.
 
@@ -62,6 +62,10 @@ uvx llm-ide-rules download [instruction_types]    # Download everything by defau
 uvx llm-ide-rules download cursor github          # Download specific types
 uvx llm-ide-rules download --repo other/repo      # Download from different repo
 
+# Delete downloaded instruction files
+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
 
 ```
 
@@ -85,8 +89,28 @@ uvx llm-ide-rules download cursor github
 
 # Download from a different repository
 uvx llm-ide-rules download --repo other-user/other-repo --target ./my-project
+
+# Delete all downloaded files (with confirmation)
+uvx llm-ide-rules delete
+
+# Delete specific instruction types
+uvx llm-ide-rules delete cursor gemini --target ./my-project
+
+# Delete without confirmation prompt
+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

{llm_ide_rules-0.2.1 → llm_ide_rules-0.4.0}/README.md

@@ -1,4 +1,4 @@
-# Copilot & Cursor LLM Instructions
+# 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.
 
@@ -48,6 +48,10 @@ uvx llm-ide-rules download [instruction_types]    # Download everything by defau
 uvx llm-ide-rules download cursor github          # Download specific types
 uvx llm-ide-rules download --repo other/repo      # Download from different repo
 
+# Delete downloaded instruction files
+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
 
 ```
 
@@ -71,8 +75,28 @@ uvx llm-ide-rules download cursor github
 
 # Download from a different repository
 uvx llm-ide-rules download --repo other-user/other-repo --target ./my-project
+
+# Delete all downloaded files (with confirmation)
+uvx llm-ide-rules delete
+
+# Delete specific instruction types
+uvx llm-ide-rules delete cursor gemini --target ./my-project
+
+# Delete without confirmation prompt
+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

{llm_ide_rules-0.2.1 → llm_ide_rules-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "llm-ide-rules"
-version = "0.2.1"
+version = "0.4.0"
 description = "CLI tool for managing LLM IDE prompts and rules"
 keywords = ["llm", "ide", "prompts", "cursor", "copilot"]
 readme = "README.md"

{llm_ide_rules-0.2.1 → llm_ide_rules-0.4.0}/src/llm_ide_rules/__init__.py

@@ -6,8 +6,9 @@ from typing_extensions import Annotated
 from llm_ide_rules.commands.explode import explode_main
 from llm_ide_rules.commands.implode import cursor, github
 from llm_ide_rules.commands.download import download_main
+from llm_ide_rules.commands.delete import delete_main
 
-__version__ = "0.2.1"
+__version__ = "0.4.0"
 
 app = typer.Typer(
     name="llm_ide_rules",
@@ -18,6 +19,7 @@ app = typer.Typer(
 # 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")

llm_ide_rules-0.4.0/src/llm_ide_rules/commands/delete.py

@@ -0,0 +1,179 @@
+"""Delete command: Remove downloaded LLM instruction files."""
+
+import logging
+import shutil
+from pathlib import Path
+from typing import List
+
+import structlog
+import typer
+from typing_extensions import Annotated
+
+from llm_ide_rules.commands.download import INSTRUCTION_TYPES, DEFAULT_TYPES
+
+logger = structlog.get_logger()
+
+
+def find_files_to_delete(
+    instruction_types: List[str], target_dir: Path
+) -> tuple[List[Path], List[Path]]:
+    """Find all files and directories that would be deleted.
+    
+    Returns:
+        Tuple of (directories, files) to delete
+    """
+    dirs_to_delete = []
+    files_to_delete = []
+
+    for inst_type in instruction_types:
+        if inst_type not in INSTRUCTION_TYPES:
+            logger.warning("Unknown instruction type", type=inst_type)
+            continue
+
+        config = INSTRUCTION_TYPES[inst_type]
+
+        for dir_name in config["directories"]:
+            dir_path = target_dir / dir_name
+            if dir_path.exists() and dir_path.is_dir():
+                dirs_to_delete.append(dir_path)
+
+        for file_name in config["files"]:
+            file_path = target_dir / file_name
+            if file_path.exists() and file_path.is_file():
+                files_to_delete.append(file_path)
+
+        for file_pattern in config.get("recursive_files", []):
+            matching_files = list(target_dir.rglob(file_pattern))
+            files_to_delete.extend([f for f in matching_files if f.is_file()])
+
+    return dirs_to_delete, files_to_delete
+
+
+def delete_main(
+    instruction_types: Annotated[
+        List[str],
+        typer.Argument(
+            help="Types of instructions to delete (cursor, github, gemini, claude, agent, agents). Deletes everything by default."
+        ),
+    ] = None,
+    target_dir: Annotated[
+        str, typer.Option("--target", "-t", help="Target directory to delete from")
+    ] = ".",
+    yes: Annotated[
+        bool,
+        typer.Option("--yes", "-y", help="Skip confirmation prompt and delete immediately"),
+    ] = False,
+    verbose: Annotated[
+        bool, typer.Option("--verbose", "-v", help="Enable verbose logging")
+    ] = False,
+):
+    """Remove downloaded LLM instruction files.
+
+    This command removes files and directories that were downloaded by the 'download' command.
+    It will show you what will be deleted and ask for confirmation before proceeding.
+
+    Examples:
+
+    \b
+    # Delete everything (with confirmation)
+    llm_ide_rules delete
+
+    \b
+    # Delete only Cursor and Gemini files
+    llm_ide_rules delete cursor gemini
+
+    \b
+    # Delete without confirmation prompt
+    llm_ide_rules delete --yes
+
+    \b
+    # Delete from a specific directory
+    llm_ide_rules delete --target ./my-project
+    """
+    if verbose:
+        logging.basicConfig(level=logging.DEBUG)
+        structlog.configure(
+            wrapper_class=structlog.make_filtering_bound_logger(logging.DEBUG),
+        )
+
+    if not instruction_types:
+        instruction_types = DEFAULT_TYPES
+
+    invalid_types = [t for t in instruction_types if t not in INSTRUCTION_TYPES]
+    if invalid_types:
+        logger.error(
+            "Invalid instruction types",
+            invalid_types=invalid_types,
+            valid_types=list(INSTRUCTION_TYPES.keys()),
+        )
+        raise typer.Exit(1)
+
+    target_path = Path(target_dir).resolve()
+
+    if not target_path.exists():
+        logger.error("Target directory does not exist", target_dir=str(target_path))
+        typer.echo(f"Error: Target directory does not exist: {target_path}")
+        raise typer.Exit(1)
+
+    logger.info(
+        "Finding files to delete",
+        instruction_types=instruction_types,
+        target_dir=str(target_path),
+    )
+
+    dirs_to_delete, files_to_delete = find_files_to_delete(
+        instruction_types, target_path
+    )
+
+    if not dirs_to_delete and not files_to_delete:
+        logger.info("No files found to delete")
+        typer.echo("No matching instruction files found to delete.")
+        return
+
+    typer.echo("\nThe following files and directories will be deleted:\n")
+
+    if dirs_to_delete:
+        typer.echo("Directories:")
+        for dir_path in sorted(dirs_to_delete):
+            relative_path = dir_path.relative_to(target_path)
+            typer.echo(f"  - {relative_path}/")
+
+    if files_to_delete:
+        typer.echo("\nFiles:")
+        for file_path in sorted(files_to_delete):
+            relative_path = file_path.relative_to(target_path)
+            typer.echo(f"  - {relative_path}")
+
+    total_items = len(dirs_to_delete) + len(files_to_delete)
+    typer.echo(f"\nTotal: {total_items} items")
+
+    if not yes:
+        typer.echo()
+        confirm = typer.confirm("Are you sure you want to delete these files?")
+        if not confirm:
+            logger.info("Deletion cancelled by user")
+            typer.echo("Deletion cancelled.")
+            raise typer.Exit(0)
+
+    deleted_count = 0
+
+    for dir_path in dirs_to_delete:
+        try:
+            logger.info("Deleting directory", path=str(dir_path))
+            shutil.rmtree(dir_path)
+            deleted_count += 1
+        except Exception as e:
+            logger.error("Failed to delete directory", path=str(dir_path), error=str(e))
+            typer.echo(f"Error deleting {dir_path}: {e}", err=True)
+
+    for file_path in files_to_delete:
+        try:
+            logger.info("Deleting file", path=str(file_path))
+            file_path.unlink()
+            deleted_count += 1
+        except Exception as e:
+            logger.error("Failed to delete file", path=str(file_path), error=str(e))
+            typer.echo(f"Error deleting {file_path}: {e}", err=True)
+
+    logger.info("Deletion completed", deleted_count=deleted_count, total_items=total_items)
+    typer.echo(f"\nSuccessfully deleted {deleted_count} of {total_items} items.")

{llm_ide_rules-0.2.1 → llm_ide_rules-0.4.0}/src/llm_ide_rules/commands/download.py

@@ -50,6 +50,7 @@ INSTRUCTION_TYPES = {
     "gemini": {"directories": [], "files": ["GEMINI.md"]},
     "claude": {"directories": [], "files": ["CLAUDE.md"]},
     "agent": {"directories": [], "files": ["AGENT.md"]},
+    "agents": {"directories": [], "files": [], "recursive_files": ["AGENTS.md"]},
 }
 
 # Default types to download when no specific types are specified
@@ -147,6 +148,60 @@ def copy_instruction_files(
                 target_file.write_bytes(source_file.read_bytes())
                 copied_items.append(file_name)
 
+        # Copy recursive files (search throughout repository)
+        for file_pattern in config.get("recursive_files", []):
+            copied_recursive = copy_recursive_files(repo_dir, target_dir, file_pattern)
+            copied_items.extend(copied_recursive)
+
+    return copied_items
+
+
+def copy_recursive_files(
+    repo_dir: Path, target_dir: Path, file_pattern: str
+) -> List[str]:
+    """Recursively copy files matching pattern, preserving directory structure.
+    
+    Only copies files to locations where the target directory already exists.
+    Warns and skips files where target directories don't exist.
+    
+    Args:
+        repo_dir: Source repository directory
+        target_dir: Target directory to copy to
+        file_pattern: File pattern to search for (e.g., "AGENTS.md")
+    
+    Returns:
+        List of copied file paths relative to target_dir
+    """
+    copied_items = []
+    
+    # Find all matching files recursively
+    matching_files = list(repo_dir.rglob(file_pattern))
+    
+    for source_file in matching_files:
+        # Calculate relative path from repo root
+        relative_path = source_file.relative_to(repo_dir)
+        target_file = target_dir / relative_path
+        
+        # Check if target directory already exists
+        target_parent = target_file.parent
+        if not target_parent.exists():
+            logger.warning(
+                "Target directory does not exist, skipping file copy",
+                target_directory=str(target_parent),
+                file=str(relative_path)
+            )
+            continue
+            
+        logger.info(
+            "Copying recursive file",
+            source=str(source_file),
+            target=str(target_file)
+        )
+        
+        # Copy file (parent directory already exists)
+        target_file.write_bytes(source_file.read_bytes())
+        copied_items.append(str(relative_path))
+    
     return copied_items
 
 
@@ -185,7 +240,7 @@ def download_main(
     instruction_types: Annotated[
         List[str],
         typer.Argument(
-            help="Types of instructions to download (cursor, github, gemini, claude, agent). Downloads everything by default."
+            help="Types of instructions to download (cursor, github, gemini, claude, agent, agents). Downloads everything by default."
         ),
     ] = None,
     repo: Annotated[