@elliotxx/claude-list 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -0,0 +1,79 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.3] - 2026-02-01
+
+### Documentation
+
+- Updated implementation task tracking for v0.1.2 colored output and search features
+- Marked all 39 tasks as complete in specs/002-colored-output-search/tasks.md
+
+## [0.1.2] - 2026-01-31
+
+### Added
+
+- **Colored Output**: Components are now displayed with distinct colors for easy identification:
+  - Plugins: Blue
+  - Skills: Green
+  - MCP Servers: Yellow
+  - Hooks: Magenta
+  - Agents: Red
+  - Commands: Orange
+  - Version Numbers: Gray
+
+- **Search Functionality**:
+  - Single keyword search (`--search keyword`)
+  - Multi-keyword AND search (`--search "keyword1 keyword2"`)
+  - Case-insensitive matching
+  - Works with all output modes (compact, detailed, JSON)
+
+- **Color Control**:
+  - `--no-color` flag to disable colors
+  - `NO_COLOR` environment variable support
+  - Automatic color disabling for non-TTY output (pipes, files)
+
+### Changed
+
+- Improved table alignment in detailed output mode (`-l`)
+- Colors automatically disabled when output is piped or redirected
+
+### Fixed
+
+- Fixed ANSI escape sequence handling for proper column alignment
+- Fixed width calculation for Unicode characters with colors
+
+### Performance
+
+- Search operations complete in under 100ms for typical configurations
+- Color rendering adds minimal overhead (<5ms)
+
+## [0.1.1] - 2026-01-29
+
+### Added
+
+- Initial release with basic component listing
+- Support for all component types: plugins, skills, sessions, MCP servers, hooks, agents, commands
+- Multiple output modes: compact, detailed (`-l`), JSON
+- Filter flags for each component type
+- Test fixtures for all component types
+
+### Features
+
+- Parse `.claude/settings.json` for plugins
+- Parse `.claude/skills/` directory for skills
+- Parse `.claude/sessions/` for session history
+- Parse `.claude/mcp.json` for MCP servers
+- Parse `.claude/hooks/` for hooks
+- Parse `.claude/agents/` for agents
+- Parse `.claude/commands/` for commands
+
+[Unreleased]: https://github.com/elliotxx/claude-list/compare/v0.1.3...HEAD
+[0.1.3]: https://github.com/elliotxx/claude-list/releases/tag/v0.1.3
+[0.1.2]: https://github.com/elliotxx/claude-list/releases/tag/v0.1.2
+[0.1.1]: https://github.com/elliotxx/claude-list/releases/tag/v0.1.1

package/README.md

@@ -28,10 +28,10 @@
 
 ## Latest News 🔥
 
+- **[2026/01]** Released v0.1.2 with colored output and search functionality
+- **[2026/01]** Released v0.1.1 with `-l` flag support and npm package
 - **[2026/01]** Published to crates.io - now installable via `cargo install claude-list`
 - **[2026/01]** Added Homebrew support with cargo-dist multi-platform builds
-- **[2026/01]** Released v0.1.0 with compact, detailed, and JSON output modes
-- **[2026/01]** Implemented 7 component parsers (plugins, skills, sessions, mcp, hooks, agents, commands)
 
 ---
 
@@ -51,8 +51,11 @@ A Rust CLI tool that follows Unix philosophy—do one thing well. It reads your
 ## Quick Start
 
 ```bash
-# Install from crates.io
-cargo install claude-list
+# Install via Homebrew (macOS)
+brew tap elliotxx/tap && brew install elliotxx/tap/claude-list
+
+# OR via shell script (Linux/macOS)
+curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elliotxx/claude-list/releases/latest/download/claude-list-installer.sh | sh
 
 # View your Claude Code environment
 claude-list
@@ -68,10 +71,43 @@ claude-list
 
 | Mode | Command | Description |
 |------|---------|-------------|
-| Compact | `claude-list` | Summary with counts |
+| Compact | `claude-list` | Summary with counts (colored by type) |
 | Detailed | `claude-list -l` | Full info with version, source, path |
 | JSON | `claude-list --json` | Machine-readable output |
 
+### Colored Output
+
+Components are displayed with distinct colors for easy identification:
+
+| Component Type | Color |
+|----------------|-------|
+| Plugins | Blue |
+| Skills | Green |
+| MCP Servers | Yellow |
+| Hooks | Magenta |
+| Agents | Red |
+| Commands | Orange |
+
+Colors are automatically disabled when:
+- Using `--no-color` flag
+- `NO_COLOR` environment variable is set
+- Output is piped or redirected
+
+### Search
+
+Search for components by name with flexible matching:
+
+```bash
+# Single keyword (case-insensitive)
+claude-list --search context
+
+# Multiple keywords (AND logic - all must match)
+claude-list --search "context plugin"
+
+# Combine with filters
+claude-list --search api --plugins
+```
+
 ### Filtering
 
 Filter to show specific component types:
@@ -102,7 +138,7 @@ claude-list --config /path/to/.claude
 ### Compact Mode (Default)
 
 ```
-CLAUDE-LIST v0.1.0
+CLAUDE-LIST v0.1.2
 
 CONFIG: /Users/user/.claude
 
@@ -125,7 +161,7 @@ MCP        2 servers
 ### Detailed Mode (`-l`)
 
 ```
-CLAUDE-LIST v0.1.0
+CLAUDE-LIST v0.1.2
 
 CONFIG: /Users/user/.claude
 
@@ -141,7 +177,7 @@ PLUGINS    3 installed
 
 ```json
 {
-  "version": "0.1.0",
+  "version": "0.1.2",
   "config_dir": "/Users/user/.claude",
   "plugins": [...],
   "skills": [...],
@@ -157,19 +193,31 @@ PLUGINS    3 installed
 
 ## Installation
 
-### Option 1: From crates.io (Recommended)
+### Option 1: From Homebrew (macOS)
 
 ```bash
-cargo install claude-list
+brew tap elliotxx/tap && brew install elliotxx/tap/claude-list
 ```
 
-### Option 2: From Homebrew (macOS)
+### Option 2: From Shell Script (Linux/macOS)
 
 ```bash
-brew tap elliotxx/tap && brew install elliotxx/tap/claude-list
+curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elliotxx/claude-list/releases/latest/download/claude-list-installer.sh | sh
+```
+
+### Option 3: From npm
+
+```bash
+npm install -g @elliotxx/claude-list
 ```
 
-### Option 3: From GitHub Releases
+### Option 4: From crates.io
+
+```bash
+cargo install claude-list
+```
+
+### Option 5: From GitHub Releases
 
 Download pre-built binaries from [GitHub Releases](https://github.com/elliotxx/claude-list/releases):
 
@@ -185,7 +233,7 @@ tar -xzf claude-list-aarch64-apple-darwin.tar.gz
 ./claude-list
 ```
 
-### Option 4: From Source
+### Option 6: From Source
 
 ```bash
 git clone https://github.com/elliotxx/claude-list.git
@@ -198,12 +246,6 @@ cargo install --path .
 
 ## Architecture
 
-### System Overview
-
-<div align="center">
-  <img src="https://via.placeholder.com/750x400?text=claude-list+Architecture" alt="Architecture Diagram" width="750">
-</div>
-
 ### Component Architecture
 
 ```
@@ -243,7 +285,7 @@ cargo install --path .
 ### Key Design Decisions
 
 - **Pattern Used**: Unix philosophy—single responsibility, compose simple tools
-- **Technology Stack**: Rust 1.75+, clap (CLI), serde (JSON), anyhow (error handling)
+- **Technology Stack**: Rust 1.75+, clap (CLI), serde (JSON), anyhow (error handling), anstyle (colors), unicode-width (ANSI width)
 - **Scalability**: Each parser is independent, easy to extend
 - **Error Handling**: Graceful degradation for missing files
 
@@ -326,13 +368,13 @@ Releases are automated via [cargo-dist](https://dist.clap.rs/):
 
 ```bash
 # 1. Update version in Cargo.toml
-# Edit Cargo.toml: version = "0.1.0" → "0.1.1"
+# Edit Cargo.toml: version = "0.1.2" → "0.1.3"
 
 # 2. Commit version change
-git add -A && git commit -m "chore: bump version to 0.1.1"
+git add -A && git commit -m "chore: bump version to 0.1.3"
 
 # 3. Create git tag
-git tag 0.1.1
+git tag 0.1.3
 
 # 4. Push to GitHub (including tags)
 git push && git push --tags
@@ -345,10 +387,11 @@ cargo publish
 
 ### CI Tokens Required
 
-| Secret | Purpose |获取位置|
-|--------|---------|--------|
+| Secret | Purpose | Location |
+|--------|---------|----------|
 | `CARGO_REGISTRY_TOKEN` | Publish to crates.io | [crates.io/settings/tokens](https://crates.io/settings/tokens) |
 | `HOMEBREW_TAP_TOKEN` | Publish to Homebrew | [GitHub Settings](https://github.com/settings/tokens) |
+| `NPM_TOKEN` | Publish to npm (requires 2FA bypass) | [npmjs.com/settings/tokens](https://www.npmjs.com/settings/tokens) |
 
 ---
 
@@ -367,7 +410,7 @@ We welcome contributions! Feel free to submit issues and pull requests.
 
 ```bash
 # Fork the repository on GitHub, then clone your fork
-git clone https://github.com/YOUR_USERNAME/claude-list.git
+git clone https://github.com/elliotxx/claude-list.git
 cd claude-list
 
 # Follow installation steps above
@@ -399,7 +442,7 @@ This project is licensed under the **MIT License** - see the [LICENSE](LICENSE)
 
 <div align="center">
   <p>
-    <strong>Built with ❤️ for the Claude Code community</strong><br>
-    <sub>Parse and display your Claude Code environment</sub>
+    <strong>Built with ❤️ for elliotxx</strong><br>
+    <sub>Parse and display your Claude Code Info</sub>
   </p>
 </div>

package/npm-shrinkwrap.json

@@ -23,7 +23,7 @@
       "hasInstallScript": true,
       "license": "MIT",
       "name": "@elliotxx/claude-list",
-      "version": "0.1.1"
+      "version": "0.1.3"
     },
     "node_modules/@isaacs/balanced-match": {
       "engines": {
@@ -515,5 +515,5 @@
     }
   },
   "requires": true,
-  "version": "0.1.1"
+  "version": "0.1.3"
 }

package/package.json

@@ -1,5 +1,5 @@
 {
-  "artifactDownloadUrl": "https://github.com/elliotxx/claude-list/releases/download/0.1.1",
+  "artifactDownloadUrl": "https://github.com/elliotxx/claude-list/releases/download/v0.1.3",
   "author": "elliot <951376975@qq.com>",
   "bin": {
     "claude-list": "run-claude-list.js"
@@ -84,7 +84,7 @@
       "zipExt": ".tar.xz"
     }
   },
-  "version": "0.1.1",
+  "version": "0.1.3",
   "volta": {
     "node": "18.14.1",
     "npm": "9.5.0"