better-icons 1.0.0 → 1.0.1

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.
package/README.md CHANGED
@@ -13,47 +13,30 @@ This MCP server solves that by giving AI models direct access to search and retr
13
13
 
14
14
  ## Quick Setup
15
15
 
16
- ### 1. Install the MCP Server
17
-
18
16
  ```bash
19
17
  npx better-icons setup
20
18
  ```
21
19
 
22
20
  This will interactively configure the MCP server for:
23
21
  - **Cursor**
24
- - **Claude Desktop**
25
- - **VS Code (Copilot)**
22
+ - **Claude Code**
23
+ - **OpenCode**
26
24
  - **Windsurf**
25
+ - **VS Code (Copilot)**
27
26
 
28
- ### 2. Add AI Rules to Your Project
27
+ ## Add AI Skills (Optional)
29
28
 
30
- Teach your AI assistant how to properly use better-icons:
29
+ Teach your AI assistant best practices for using better-icons:
31
30
 
32
31
  ```bash
33
32
  npx skills add better-auth/better-icons
34
33
  ```
35
34
 
36
- Or install rules directly (supports multiple editors):
37
-
38
- ```bash
39
- npx better-icons rules
40
- ```
41
-
42
- This opens an interactive selector for:
43
- - **Cursor**
44
- - **Claude Code**
45
- - **Windsurf**
46
- - **OpenCode**
47
- - **GitHub Copilot**
48
- - **Cline / Roo**
49
- - **Aider**
50
-
51
- The rules ensure AI assistants will:
35
+ This ensures AI assistants will:
52
36
  - ✅ Use the `better-icons` MCP instead of installing icon packages
53
- - ✅ Create a single `icons.tsx` file with all icons
37
+ - ✅ For React, create a single `icons.tsx` file with all icons
54
38
  - ✅ Reuse existing icons before adding new ones
55
39
  - ✅ Follow consistent naming conventions
56
- - ❌ Never install `lucide-react`, `react-icons`, `@heroicons/react`, etc.
57
40
 
58
41
  ## Manual Installation
59
42
 
@@ -72,9 +55,9 @@ Add to `~/.cursor/mcp.json`:
72
55
  }
73
56
  ```
74
57
 
75
- ### Claude Desktop
58
+ ### Claude Code (CLI)
76
59
 
77
- Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
60
+ Add to `~/.claude/settings.json`:
78
61
 
79
62
  ```json
80
63
  {
@@ -166,13 +149,27 @@ Recommend icons for user authentication
166
149
  ## CLI Commands
167
150
 
168
151
  ```bash
169
- npx better-icons # Run the MCP server
170
- npx better-icons setup # Interactive setup wizard
171
- npx better-icons rules # Install AI rules to your project
172
- npx better-icons config # Show manual config instructions
173
- npx better-icons help # Show help
152
+ npx better-icons # Run the MCP server (for tool configs)
153
+ npx better-icons setup # Interactive setup wizard
154
+ npx better-icons setup -y # Setup with auto-confirm (global)
155
+ npx better-icons setup -s project # Setup for current project only
156
+ npx better-icons config # Show manual config instructions
157
+ npx better-icons --help # Show help
174
158
  ```
175
159
 
160
+ ### Options
161
+
162
+ | Option | Description |
163
+ |--------|-------------|
164
+ | `-y, --yes` | Skip confirmation prompts |
165
+ | `-a, --agent <agents...>` | Specify agents (cursor, claude-code, opencode, windsurf, vscode) |
166
+ | `-s, --scope <scope>` | Config scope: `global` (default) or `project` |
167
+
168
+ ### Scope
169
+
170
+ - **Global**: Configures MCP server for all projects (stored in home directory)
171
+ - **Project**: Configures MCP server for current project only (stored in project root)
172
+
176
173
  ## Development
177
174
 
178
175
  ```bash
@@ -180,9 +177,9 @@ npx better-icons help # Show help
180
177
  bun install
181
178
 
182
179
  # Run locally
183
- bun run index.ts
180
+ bun run dev
184
181
 
185
- # Build for publishing
182
+ # Build
186
183
  bun run build
187
184
  ```
188
185