llm-ide-rules 0.4.0__py3-none-any.whl → 0.6.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- llm_ide_rules/__init__.py +53 -7
- llm_ide_rules/__main__.py +1 -1
- llm_ide_rules/agents/__init__.py +28 -0
- llm_ide_rules/agents/base.py +283 -0
- llm_ide_rules/agents/claude.py +92 -0
- llm_ide_rules/agents/cursor.py +178 -0
- llm_ide_rules/agents/gemini.py +161 -0
- llm_ide_rules/agents/github.py +207 -0
- llm_ide_rules/agents/opencode.py +126 -0
- llm_ide_rules/commands/delete.py +24 -34
- llm_ide_rules/commands/download.py +52 -56
- llm_ide_rules/commands/explode.py +227 -243
- llm_ide_rules/commands/implode.py +229 -202
- llm_ide_rules/commands/mcp.py +119 -0
- llm_ide_rules/constants.py +17 -14
- llm_ide_rules/log.py +9 -0
- llm_ide_rules/mcp/__init__.py +7 -0
- llm_ide_rules/mcp/models.py +21 -0
- llm_ide_rules/sections.json +4 -5
- {llm_ide_rules-0.4.0.dist-info → llm_ide_rules-0.6.0.dist-info}/METADATA +35 -59
- llm_ide_rules-0.6.0.dist-info/RECORD +23 -0
- {llm_ide_rules-0.4.0.dist-info → llm_ide_rules-0.6.0.dist-info}/WHEEL +2 -2
- llm_ide_rules-0.4.0.dist-info/RECORD +0 -12
- {llm_ide_rules-0.4.0.dist-info → llm_ide_rules-0.6.0.dist-info}/entry_points.txt +0 -0
|
@@ -1,20 +1,23 @@
|
|
|
1
1
|
Metadata-Version: 2.3
|
|
2
2
|
Name: llm-ide-rules
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.6.0
|
|
4
4
|
Summary: CLI tool for managing LLM IDE prompts and rules
|
|
5
5
|
Keywords: llm,ide,prompts,cursor,copilot
|
|
6
6
|
Author: Michael Bianco
|
|
7
7
|
Author-email: Michael Bianco <mike@mikebian.co>
|
|
8
8
|
Requires-Dist: typer>=0.9.0
|
|
9
|
-
Requires-Dist: structlog>=
|
|
9
|
+
Requires-Dist: structlog-config>=0.6.0
|
|
10
10
|
Requires-Dist: requests>=2.25.0
|
|
11
|
-
Requires-
|
|
11
|
+
Requires-Dist: pydantic>=2.0.0
|
|
12
|
+
Requires-Dist: json5>=0.9.0
|
|
13
|
+
Requires-Dist: tomli-w>=1.0.0
|
|
14
|
+
Requires-Python: >=3.11
|
|
12
15
|
Project-URL: Repository, https://github.com/iloveitaly/llm-ide-rules
|
|
13
16
|
Description-Content-Type: text/markdown
|
|
14
17
|
|
|
15
18
|
# Copilot, Cursor, Claude, Gemini, etc LLM Instructions
|
|
16
19
|
|
|
17
|
-
|
|
20
|
+
This project makes it easy to download prompts and implode/explode them so they can be used by various providers.
|
|
18
21
|
|
|
19
22
|
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.
|
|
20
23
|
|
|
@@ -22,25 +25,28 @@ Additionally, it becomes challenging to copy these prompts into various projects
|
|
|
22
25
|
|
|
23
26
|
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.
|
|
24
27
|
|
|
25
|
-
##
|
|
26
|
-
|
|
27
|
-
You can run the `llm-ide-rules` CLI tool using uvx:
|
|
28
|
+
## IDE Format Comparison
|
|
28
29
|
|
|
29
|
-
|
|
30
|
-
uvx llm-ide-rules
|
|
31
|
-
```
|
|
30
|
+
Different AI coding assistants use different formats for instructions and commands:
|
|
32
31
|
|
|
33
|
-
|
|
32
|
+
| IDE | type | folder | Notes |
|
|
33
|
+
|-----|------|--------|-------|
|
|
34
|
+
| **Cursor** | instructions | `.cursor/rules/*.mdc` | Multiple plain markdown files |
|
|
35
|
+
| **Cursor** | commands | `.cursor/commands/*.md` | Plain markdown, no frontmatter |
|
|
36
|
+
| **Claude Code** | instructions | `CLAUDE.md` | Single markdown file at root |
|
|
37
|
+
| **Claude Code** | instructions | `AGENT.md` | Single markdown file at root (agent-specific) |
|
|
38
|
+
| **Claude Code** | commands | `.claude/commands/*.md` | Plain markdown, no frontmatter |
|
|
39
|
+
| **GitHub Copilot** | instructions | `.github/copilot-instructions.md` | Single markdown file |
|
|
40
|
+
| **GitHub Copilot** | instructions | `.github/instructions/*.instructions.md` | Multiple instruction files |
|
|
41
|
+
| **GitHub Copilot** | prompts | `.github/prompts/*.prompt.md` | YAML frontmatter with `mode: 'agent'` |
|
|
42
|
+
| **Gemini CLI** | instructions | `GEMINI.md` | Single markdown file at root |
|
|
43
|
+
| **Gemini CLI** | commands | `.gemini/commands/*.toml` | TOML format, supports `{{args}}` and shell commands |
|
|
44
|
+
| **OpenCode** | commands | `.opencode/commands/*.md` | Plain markdown, no frontmatter |
|
|
34
45
|
|
|
35
|
-
|
|
36
|
-
uv tool install git+https://github.com/iloveitaly/llm-ide-rules.git
|
|
37
|
-
```
|
|
46
|
+
## Installation
|
|
38
47
|
|
|
39
48
|
```sh
|
|
40
|
-
|
|
41
|
-
cd llm-ide-rules
|
|
42
|
-
uv sync
|
|
43
|
-
source .venv/bin/activate
|
|
49
|
+
uvx llm-ide-rules@latest --help
|
|
44
50
|
```
|
|
45
51
|
|
|
46
52
|
## Usage
|
|
@@ -55,7 +61,10 @@ uvx llm-ide-rules explode [input_file]
|
|
|
55
61
|
|
|
56
62
|
# Bundle rule files back into a single instruction file
|
|
57
63
|
uvx llm-ide-rules implode cursor [output_file] # Bundle Cursor rules
|
|
58
|
-
uvx llm-ide-rules implode github [output_file]
|
|
64
|
+
uvx llm-ide-rules implode github [output_file] # Bundle GitHub/Copilot instructions
|
|
65
|
+
uvx llm-ide-rules implode claude [output_file] # Bundle Claude Code commands
|
|
66
|
+
uvx llm-ide-rules implode gemini [output_file] # Bundle Gemini CLI commands
|
|
67
|
+
uvx llm-ide-rules implode opencode [output_file] # Bundle OpenCode commands
|
|
59
68
|
|
|
60
69
|
# Download instruction files from repositories
|
|
61
70
|
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
|
|
|
66
75
|
uvx llm-ide-rules delete [instruction_types] # Delete everything by default
|
|
67
76
|
uvx llm-ide-rules delete cursor gemini # Delete specific types
|
|
68
77
|
uvx llm-ide-rules delete --yes # Skip confirmation prompt
|
|
69
|
-
|
|
70
78
|
```
|
|
71
79
|
|
|
72
80
|
### Examples
|
|
73
81
|
|
|
74
82
|
```sh
|
|
75
|
-
# Explode instructions.md into
|
|
83
|
+
# Explode instructions.md into all supported formats (cursor, github, claude, gemini, opencode)
|
|
76
84
|
uvx llm-ide-rules explode instructions.md
|
|
77
85
|
|
|
86
|
+
# Explode for a specific agent only
|
|
87
|
+
uvx llm-ide-rules explode instructions.md --agent opencode
|
|
88
|
+
|
|
78
89
|
# Bundle Cursor rules back into a single file
|
|
79
90
|
uvx llm-ide-rules implode cursor bundled-instructions.md
|
|
80
91
|
|
|
81
92
|
# Bundle GitHub instructions with verbose logging
|
|
82
93
|
uvx llm-ide-rules implode github --verbose instructions.md
|
|
83
94
|
|
|
95
|
+
# Bundle OpenCode commands into commands.md
|
|
96
|
+
uvx llm-ide-rules implode opencode
|
|
97
|
+
|
|
84
98
|
# Download everything from default repository
|
|
85
99
|
uvx llm-ide-rules download
|
|
86
100
|
|
|
@@ -100,44 +114,6 @@ uvx llm-ide-rules delete cursor gemini --target ./my-project
|
|
|
100
114
|
uvx llm-ide-rules delete --yes
|
|
101
115
|
```
|
|
102
116
|
|
|
103
|
-
### IDE Command Format Comparison
|
|
104
|
-
|
|
105
|
-
Different AI coding assistants use different formats for commands:
|
|
106
|
-
|
|
107
|
-
| IDE | Directory | Format | Notes |
|
|
108
|
-
|-----|-----------|--------|-------|
|
|
109
|
-
| **Cursor** | `.cursor/commands/` | `.md` (plain markdown) | Simple, no frontmatter |
|
|
110
|
-
| **Claude Code** | `.claude/commands/` | `.md` (plain markdown) | Simple, no frontmatter |
|
|
111
|
-
| **GitHub Copilot** | `.github/prompts/` | `.prompt.md` (YAML + markdown) | Requires frontmatter with `mode: 'agent'` |
|
|
112
|
-
| **Gemini CLI** | `.gemini/commands/` | `.toml` | Uses TOML format, supports `{{args}}` and shell commands |
|
|
113
|
-
|
|
114
|
-
## Development
|
|
115
|
-
|
|
116
|
-
### Using the CLI for Development
|
|
117
|
-
|
|
118
|
-
The CLI replaces the old standalone scripts. Use the CLI commands in your development workflow:
|
|
119
|
-
|
|
120
|
-
```shell
|
|
121
|
-
# Setup the environment
|
|
122
|
-
uv sync
|
|
123
|
-
|
|
124
|
-
# Explode instructions into separate rule files
|
|
125
|
-
uvx llm-ide-rules explode
|
|
126
|
-
|
|
127
|
-
# Bundle rules back into instructions
|
|
128
|
-
uvx llm-ide-rules implode cursor instructions.md
|
|
129
|
-
```
|
|
130
|
-
|
|
131
|
-
### Building and Testing
|
|
132
|
-
|
|
133
|
-
```shell
|
|
134
|
-
# Build the package
|
|
135
|
-
uv build
|
|
136
|
-
|
|
137
|
-
# Run tests
|
|
138
|
-
pytest
|
|
139
|
-
```
|
|
140
|
-
|
|
141
117
|
## Extracting Changes
|
|
142
118
|
|
|
143
119
|
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.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
llm_ide_rules/__init__.py,sha256=HiB0P4fycSvvJvVeCQYH3WuoJ3jB8NvJV3Cc3k5U2CA,2201
|
|
2
|
+
llm_ide_rules/__main__.py,sha256=8maIDGnEcSUBs9lXg7YEevCXPC0fisYPC2gAEXHfHGM,145
|
|
3
|
+
llm_ide_rules/agents/__init__.py,sha256=-KfKLr_qG26t2OXi1dA-gCesPDqS1ARGa6hELdoyCo0,905
|
|
4
|
+
llm_ide_rules/agents/base.py,sha256=dp7Z3YJtbpQCtEBRdsFedNmljJuqe-C5Vyi8c91vQ2U,8915
|
|
5
|
+
llm_ide_rules/agents/claude.py,sha256=MpdrbhudiD54-EakCb2YPQEKKCd0P2R9c7Gp4umkA2E,2624
|
|
6
|
+
llm_ide_rules/agents/cursor.py,sha256=CDdarb9_SRDmwAVpQWPqX6NoyTyuuWVB_fr-lzxWSGU,5195
|
|
7
|
+
llm_ide_rules/agents/gemini.py,sha256=NnXlOlt4NLzoASjpmNBo079UCGdRR94-2DSC2VxKr7Y,4966
|
|
8
|
+
llm_ide_rules/agents/github.py,sha256=fhM3KpS3TP0LIA0TM6waOuuEsKRsCj3xZRwTetaOImI,6739
|
|
9
|
+
llm_ide_rules/agents/opencode.py,sha256=fNvN91_GCs9b_hFIBhmSdEiky6u7o4Rn5kqQlnj2PXw,3861
|
|
10
|
+
llm_ide_rules/commands/delete.py,sha256=m8hSDD5jruj6QN0w8zuRmrmX-SfscXjuEWwrGy3v0fs,5490
|
|
11
|
+
llm_ide_rules/commands/download.py,sha256=3ipuZwYDKVDtl82Yxyv-VgjFZa8ZCTIxbXGAu0HV6Qc,10792
|
|
12
|
+
llm_ide_rules/commands/explode.py,sha256=M12pXyo5dGKqsgTFWfJC7xNGuXeBqV5ZIp6kHaipjwM,11761
|
|
13
|
+
llm_ide_rules/commands/implode.py,sha256=nVsK3PB9hGYukA7iPEGP5cRwQn3Ma79nC8txf-ES8m8,8161
|
|
14
|
+
llm_ide_rules/commands/mcp.py,sha256=61juJyWe7BQrOisWH67-ynTBe3xjBPGq-s-HAzPWVrU,3680
|
|
15
|
+
llm_ide_rules/constants.py,sha256=2m4yYcWOcLw82P8VF6py7LXDtwfBywOrJK4SHFfyPOY,1163
|
|
16
|
+
llm_ide_rules/log.py,sha256=hfkCLaTf2juQ7n67BYNREUrFxXDh6hqNcN2Pt9YTOo8,322
|
|
17
|
+
llm_ide_rules/mcp/__init__.py,sha256=g73PAMhN7jDqmTBGskWJg2atpPj_-tiVY9ww7YqO2Yw,118
|
|
18
|
+
llm_ide_rules/mcp/models.py,sha256=gYzhgdWQwhH3pmj6OWVFWNNKRgxcblXeE3car2Tv8O4,440
|
|
19
|
+
llm_ide_rules/sections.json,sha256=fY5dY7hIMfHAiLT7OHMj-_iV83LYv5-BL6o9iOXSmOE,536
|
|
20
|
+
llm_ide_rules-0.6.0.dist-info/WHEEL,sha256=XV0cjMrO7zXhVAIyyc8aFf1VjZ33Fen4IiJk5zFlC3g,80
|
|
21
|
+
llm_ide_rules-0.6.0.dist-info/entry_points.txt,sha256=xsALXWBwSEifz-2Mike7s2SwqNu1taLs_-EcmGrONeM,54
|
|
22
|
+
llm_ide_rules-0.6.0.dist-info/METADATA,sha256=WHPO5PBdkCh1g6diZjOBmDzTGnsI8P621LUvCuJbxTk,5318
|
|
23
|
+
llm_ide_rules-0.6.0.dist-info/RECORD,,
|
|
@@ -1,12 +0,0 @@
|
|
|
1
|
-
llm_ide_rules/__init__.py,sha256=03b18e9945a42a481e3f4c345ee9550792b83496bee0a708bafad8d7c6dfcf17,1246
|
|
2
|
-
llm_ide_rules/__main__.py,sha256=881447dbad0fe837590fa8224f1d0dd70416fd5344779978d07744ff8e0cf868,144
|
|
3
|
-
llm_ide_rules/commands/delete.py,sha256=6ed0a44b1be1d950180831681d79e3a0be91cd37296e30e7a0d821d49292ebf4,5812
|
|
4
|
-
llm_ide_rules/commands/download.py,sha256=06c2a841db5fe0b0f7f3e8c99ad198c8e07e53d8801fb4d95e802ecee60cda31,11022
|
|
5
|
-
llm_ide_rules/commands/explode.py,sha256=a8ace601155055a0061e47da7e99a672334796f1ebb91b24c3adf905f65e1645,11196
|
|
6
|
-
llm_ide_rules/commands/implode.py,sha256=35282bfc83be808f12e9e9ce7af1bae4069e53bd8f441948e3551339b2e9418d,8847
|
|
7
|
-
llm_ide_rules/constants.py,sha256=1182b9757ca58d038a4878d1b55570aac4f0287f1a5ab5af8d68331b799b0686,1118
|
|
8
|
-
llm_ide_rules/sections.json,sha256=9ed1725e44d8a29364e5ac3f01e0e6e03ff17cd45c280846659b7f73940b668b,549
|
|
9
|
-
llm_ide_rules-0.4.0.dist-info/WHEEL,sha256=0f7d664a881437bddec71c703c3c2f01fd13581519f95130abcc96e296ef0426,79
|
|
10
|
-
llm_ide_rules-0.4.0.dist-info/entry_points.txt,sha256=c6c00b5d607048489fcfed8c8a47bbb364b0a8dbb5b5a2ecffe11c986ace35e3,54
|
|
11
|
-
llm_ide_rules-0.4.0.dist-info/METADATA,sha256=dfa81f3d0100761f18547dd23e3c15343c6f8341ab27622b6b89b59860bb3ebe,4898
|
|
12
|
-
llm_ide_rules-0.4.0.dist-info/RECORD,,
|
|
File without changes
|