@elliotxx/claude-list 0.1.1

package/.gitignore

@@ -0,0 +1,2 @@
+/node_modules
+

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 elliotxx
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,405 @@
+<div align="center">
+
+  <div>
+    <img src="assets/logo.svg" alt="claude-list Logo" width="128" height="128">
+  </div>
+
+  <h1 style="margin-top: 10px;">claude-list</h1>
+
+  CLI tool for viewing installed plugins, skills, agents, and MCP servers in Claude Code.
+
+  <div align="center">
+    <a href="https://github.com/elliotxx/claude-list/actions"><img alt="CI Status" src="https://img.shields.io/github/actions/workflow/status/elliotxx/claude-list?logo=github"/></a>
+    <a href="https://crates.io/crates/claude-list"><img alt="Crates.io" src="https://img.shields.io/crates/v/claude-list"/></a>
+    <a href="https://github.com/elliotxx/claude-list/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/badge/License-MIT-yellow.svg"/></a>
+    <a href="https://www.rust-lang.org/"><img alt="Rust" src="https://img.shields.io/badge/Rust-1.75+-orange.svg"/></a>
+  </div>
+
+  <p>
+    <a href="#why-claude-list">Why?</a>
+    ◆ <a href="#quick-start">Quick Start</a>
+    ◆ <a href="#features">Features</a>
+    ◆ <a href="#installation">Installation</a>
+    ◆ <a href="#architecture">Architecture</a>
+  </p>
+</div>
+
+---
+
+## Latest News 🔥
+
+- **[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)
+
+---
+
+## Why claude-list?
+
+A Rust CLI tool that follows Unix philosophy—do one thing well. It reads your Claude Code `.claude` directory and presents key information in a clean, minimal format with modern aesthetics.
+
+- **🎨 Clean Output** - Human-readable compact format by default
+- **🔍 Detailed Views** - Version, source, and path information on demand
+- **🤖 Scriptable** - JSON output for automation and integration
+- **⚡ Fast** - Sub-second execution (< 0.03s)
+- **🔒 Safe** - Handles missing files and partial data gracefully
+- **📦 Multi-Platform** - Pre-built binaries for Linux and macOS
+
+---
+
+## Quick Start
+
+```bash
+# Install from crates.io
+cargo install claude-list
+
+# View your Claude Code environment
+claude-list
+```
+
+**Need more details?** See [Installation](#installation) below for all installation options.
+
+---
+
+## Features
+
+### Output Modes
+
+| Mode | Command | Description |
+|------|---------|-------------|
+| Compact | `claude-list` | Summary with counts |
+| Detailed | `claude-list -l` | Full info with version, source, path |
+| JSON | `claude-list --json` | Machine-readable output |
+
+### Filtering
+
+Filter to show specific component types:
+
+```bash
+claude-list --plugins    # Only plugins
+claude-list --skills     # Only skills
+claude-list --sessions   # Only sessions
+claude-list --mcp        # Only MCP servers
+claude-list --hooks      # Only hooks
+claude-list --agents     # Only agents
+claude-list --commands   # Only commands
+
+# Combine filters
+claude-list --plugins --skills
+```
+
+### Custom Configuration Directory
+
+```bash
+claude-list --config /path/to/.claude
+```
+
+---
+
+## Demo
+
+### Compact Mode (Default)
+
+```
+CLAUDE-LIST v0.1.0
+
+CONFIG: /Users/user/.claude
+
+PLUGINS    3 installed
+  context7
+  plugin_playwright
+  plugin_example
+
+SKILLS     12 available
+  brainstorming
+  claude-code-guide
+  ...
+
+SESSIONS   47 recorded
+MCP        2 servers
+  test-mcp
+  another-mcp
+```
+
+### Detailed Mode (`-l`)
+
+```
+CLAUDE-LIST v0.1.0
+
+CONFIG: /Users/user/.claude
+
+PLUGINS    3 installed
+  NAME                 VERSION  SOURCE     PATH
+  -------------------  -------  ---------  ---------------------------------
+  context7             2.1.0    official   /Users/user/.claude/settings.json
+  plugin_playwright    1.0.0    third-party /Users/user/.claude/settings.json
+  plugin_example       0.5.0    community  /Users/user/.claude/settings.json
+```
+
+### JSON Mode (`--json`)
+
+```json
+{
+  "version": "0.1.0",
+  "config_dir": "/Users/user/.claude",
+  "plugins": [...],
+  "skills": [...],
+  "sessions": {...},
+  "mcp_servers": [...],
+  "hooks": [...],
+  "agents": [...],
+  "commands": [...]
+}
+```
+
+---
+
+## Installation
+
+### Option 1: From crates.io (Recommended)
+
+```bash
+cargo install claude-list
+```
+
+### Option 2: From Homebrew (macOS)
+
+```bash
+brew tap elliotxx/tap && brew install elliotxx/tap/claude-list
+```
+
+### Option 3: From GitHub Releases
+
+Download pre-built binaries from [GitHub Releases](https://github.com/elliotxx/claude-list/releases):
+
+```bash
+# Linux (x86_64)
+wget https://github.com/elliotxx/claude-list/releases/latest/download/claude-list-x86_64-unknown-linux-gnu.tar.gz
+tar -xzf claude-list-x86_64-unknown-linux-gnu.tar.gz
+./claude-list
+
+# macOS (Apple Silicon)
+wget https://github.com/elliotxx/claude-list/releases/latest/download/claude-list-aarch64-apple-darwin.tar.gz
+tar -xzf claude-list-aarch64-apple-darwin.tar.gz
+./claude-list
+```
+
+### Option 4: From Source
+
+```bash
+git clone https://github.com/elliotxx/claude-list.git
+cd claude-list
+cargo build --release
+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
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                      User Input                          │
+│                    (CLI Arguments)                       │
+└──────────────────────┬──────────────────────────────────┘
+                       │
+                       ▼
+┌─────────────────────────────────────────────────────────┐
+│  Main Entry Point (src/main.rs)                         │
+│  • Parse CLI arguments                                  │
+│  • Dispatch to formatters                               │
+└──────────────────────┬──────────────────────────────────┘
+                       │
+                       ▼
+┌─────────────────────────────────────────────────────────┐
+│  Parser Layer (src/parsers/)                            │
+│  • plugins.rs    → Parse installed plugins              │
+│  • skills.rs     → Parse skills                         │
+│  • sessions.rs   → Parse session history                │
+│  • mcp.rs        → Parse MCP servers                    │
+│  • hooks.rs      → Parse hooks                          │
+│  • agents.rs     → Parse agents                         │
+│  • commands.rs   → Parse commands                       │
+└──────────────────────┬──────────────────────────────────┘
+                       │
+                       ▼
+┌─────────────────────────────────────────────────────────┐
+│  Formatter Layer (src/formatters/)                      │
+│  • compact.rs    → Human-readable summary               │
+│  • detailed.rs   → Full info with version/source/path   │
+│  • json.rs       → Machine-readable JSON output         │
+└─────────────────────────────────────────────────────────┘
+```
+
+### Key Design Decisions
+
+- **Pattern Used**: Unix philosophy—single responsibility, compose simple tools
+- **Technology Stack**: Rust 1.75+, clap (CLI), serde (JSON), anyhow (error handling)
+- **Scalability**: Each parser is independent, easy to extend
+- **Error Handling**: Graceful degradation for missing files
+
+### Supported Data Sources
+
+| Component | Format | Location |
+|-----------|--------|----------|
+| Plugins | JSON | `.claude/plugins/installed_plugins.json` |
+| Skills | YAML | `.claude/skills/*/skill.yaml` |
+| MCP Servers | Directory/YAML | `.claude/mcp-servers/*/` |
+| Sessions | JSON Lines | `.claude/history.jsonl` |
+| Commands | Markdown | `.claude/commands/*.md` |
+| Agents | Markdown | `.claude/agents/*.md` |
+| Hooks | Markdown | `.claude/hooks/*.md` |
+
+---
+
+## Development
+
+### Prerequisites
+
+- Rust 1.75+
+- Cargo
+
+### Quick Start
+
+```bash
+# Run all checks
+cargo fmt && cargo clippy && cargo test
+
+# Run tests only
+cargo test
+
+# Run integration tests
+cargo test --test cli_test
+```
+
+### Building
+
+```bash
+# Debug build
+cargo build
+
+# Release build
+cargo build --release
+
+# Check format
+cargo fmt --check
+
+# Run clippy
+cargo clippy --all-features -- -D warnings
+```
+
+### Testing
+
+```bash
+# Run all tests
+cargo test --all-features
+
+# Run with verbose output
+cargo test --all-features --verbose
+
+# Run specific test
+cargo test test_name
+```
+
+---
+
+## Publishing
+
+Releases are automated via [cargo-dist](https://dist.clap.rs/):
+
+1. Push a git tag matching `x.y.z` (e.g., `0.1.1`)
+2. CI pipeline triggers automatically:
+   - **Plan**: Generate build manifest
+   - **Build**: Multi-platform builds (x86_64 Linux, x86_64/aarch64 macOS)
+   - **Publish**: GitHub Release + Homebrew
+
+### Release Process
+
+```bash
+# 1. Update version in Cargo.toml
+# Edit Cargo.toml: version = "0.1.0" → "0.1.1"
+
+# 2. Commit version change
+git add -A && git commit -m "chore: bump version to 0.1.1"
+
+# 3. Create git tag
+git tag 0.1.1
+
+# 4. Push to GitHub (including tags)
+git push && git push --tags
+
+# 5. After CI completes, manually publish to crates.io
+cargo publish
+```
+
+> **Note**: Publishing to crates.io requires manual `cargo publish` as cargo-dist does not support automatic crates.io publishing.
+
+### CI Tokens Required
+
+| Secret | Purpose |获取位置|
+|--------|---------|--------|
+| `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) |
+
+---
+
+## Contributing
+
+We welcome contributions! Feel free to submit issues and pull requests.
+
+### Contribution Areas
+
+- **Feature Development**: Add new parsers or formatters
+- **Bug Fixes**: Fix issues and improve stability
+- **Documentation**: Improve guides and examples
+- **Testing**: Add tests and improve coverage
+
+### Quick Start for Contributors
+
+```bash
+# Fork the repository on GitHub, then clone your fork
+git clone https://github.com/YOUR_USERNAME/claude-list.git
+cd claude-list
+
+# Follow installation steps above
+
+# Create feature branch
+git checkout -b feature/your-feature-name
+
+# Make changes, test, then commit and push
+git add .
+git commit -m "feat: description"
+git push origin feature/your-feature-name
+```
+
+---
+
+## License
+
+This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
+
+---
+
+## Acknowledgments
+
+- [Claude Code](https://claude.com/claude-code) for the inspiration
+- [clap](https://github.com/clap-rs/clap) for CLI argument parsing
+- [cargo-dist](https://github.com/axodotdev/cargo-dist) for automated releases
+
+---
+
+<div align="center">
+  <p>
+    <strong>Built with ❤️ for the Claude Code community</strong><br>
+    <sub>Parse and display your Claude Code environment</sub>
+  </p>
+</div>

package/binary-install.js

@@ -0,0 +1,212 @@
+const { createWriteStream, existsSync, mkdirSync, mkdtemp } = require("fs");
+const { join, sep } = require("path");
+const { spawnSync } = require("child_process");
+const { tmpdir } = require("os");
+
+const axios = require("axios");
+const rimraf = require("rimraf");
+const tmpDir = tmpdir();
+
+const error = (msg) => {
+  console.error(msg);
+  process.exit(1);
+};
+
+class Package {
+  constructor(platform, name, url, filename, zipExt, binaries) {
+    let errors = [];
+    if (typeof url !== "string") {
+      errors.push("url must be a string");
+    } else {
+      try {
+        new URL(url);
+      } catch (e) {
+        errors.push(e);
+      }
+    }
+    if (name && typeof name !== "string") {
+      errors.push("package name must be a string");
+    }
+    if (!name) {
+      errors.push("You must specify the name of your package");
+    }
+    if (binaries && typeof binaries !== "object") {
+      errors.push("binaries must be a string => string map");
+    }
+    if (!binaries) {
+      errors.push("You must specify the binaries in the package");
+    }
+
+    if (errors.length > 0) {
+      let errorMsg =
+        "One or more of the parameters you passed to the Binary constructor are invalid:\n";
+      errors.forEach((error) => {
+        errorMsg += error;
+      });
+      errorMsg +=
+        '\n\nCorrect usage: new Package("my-binary", "https://example.com/binary/download.tar.gz", {"my-binary": "my-binary"})';
+      error(errorMsg);
+    }
+
+    this.platform = platform;
+    this.url = url;
+    this.name = name;
+    this.filename = filename;
+    this.zipExt = zipExt;
+    this.installDirectory = join(__dirname, "node_modules", ".bin_real");
+    this.binaries = binaries;
+
+    if (!existsSync(this.installDirectory)) {
+      mkdirSync(this.installDirectory, { recursive: true });
+    }
+  }
+
+  exists() {
+    for (const binaryName in this.binaries) {
+      const binRelPath = this.binaries[binaryName];
+      const binPath = join(this.installDirectory, binRelPath);
+      if (!existsSync(binPath)) {
+        return false;
+      }
+    }
+    return true;
+  }
+
+  install(fetchOptions, suppressLogs = false) {
+    if (this.exists()) {
+      if (!suppressLogs) {
+        console.error(
+          `${this.name} is already installed, skipping installation.`,
+        );
+      }
+      return Promise.resolve();
+    }
+
+    if (existsSync(this.installDirectory)) {
+      rimraf.sync(this.installDirectory);
+    }
+
+    mkdirSync(this.installDirectory, { recursive: true });
+
+    if (!suppressLogs) {
+      console.error(`Downloading release from ${this.url}`);
+    }
+
+    return axios({ ...fetchOptions, url: this.url, responseType: "stream" })
+      .then((res) => {
+        return new Promise((resolve, reject) => {
+          mkdtemp(`${tmpDir}${sep}`, (err, directory) => {
+            let tempFile = join(directory, this.filename);
+            const sink = res.data.pipe(createWriteStream(tempFile));
+            sink.on("error", (err) => reject(err));
+            sink.on("close", () => {
+              if (/\.tar\.*/.test(this.zipExt)) {
+                const result = spawnSync("tar", [
+                  "xf",
+                  tempFile,
+                  // The tarballs are stored with a leading directory
+                  // component; we strip one component in the
+                  // shell installers too.
+                  "--strip-components",
+                  "1",
+                  "-C",
+                  this.installDirectory,
+                ]);
+                if (result.status == 0) {
+                  resolve();
+                } else if (result.error) {
+                  reject(result.error);
+                } else {
+                  reject(
+                    new Error(
+                      `An error occurred untarring the artifact: stdout: ${result.stdout}; stderr: ${result.stderr}`,
+                    ),
+                  );
+                }
+              } else if (this.zipExt == ".zip") {
+                let result;
+                if (this.platform.artifactName.includes("windows")) {
+                  // Windows does not have "unzip" by default on many installations, instead
+                  // we use Expand-Archive from powershell
+                  result = spawnSync("powershell.exe", [
+                    "-NoProfile",
+                    "-NonInteractive",
+                    "-Command",
+                    `& {
+                        param([string]$LiteralPath, [string]$DestinationPath)
+                        Expand-Archive -LiteralPath $LiteralPath -DestinationPath $DestinationPath -Force
+                    }`,
+                    tempFile,
+                    this.installDirectory,
+                  ]);
+                } else {
+                  result = spawnSync("unzip", [
+                    "-q",
+                    tempFile,
+                    "-d",
+                    this.installDirectory,
+                  ]);
+                }
+
+                if (result.status == 0) {
+                  resolve();
+                } else if (result.error) {
+                  reject(result.error);
+                } else {
+                  reject(
+                    new Error(
+                      `An error occurred unzipping the artifact: stdout: ${result.stdout}; stderr: ${result.stderr}`,
+                    ),
+                  );
+                }
+              } else {
+                reject(
+                  new Error(`Unrecognized file extension: ${this.zipExt}`),
+                );
+              }
+            });
+          });
+        });
+      })
+      .then(() => {
+        if (!suppressLogs) {
+          console.error(`${this.name} has been installed!`);
+        }
+      })
+      .catch((e) => {
+        error(`Error fetching release: ${e.message}`);
+      });
+  }
+
+  run(binaryName, fetchOptions) {
+    const promise = !this.exists()
+      ? this.install(fetchOptions, true)
+      : Promise.resolve();
+
+    promise
+      .then(() => {
+        const [, , ...args] = process.argv;
+
+        const options = { cwd: process.cwd(), stdio: "inherit" };
+
+        const binRelPath = this.binaries[binaryName];
+        if (!binRelPath) {
+          error(`${binaryName} is not a known binary in ${this.name}`);
+        }
+        const binPath = join(this.installDirectory, binRelPath);
+        const result = spawnSync(binPath, args, options);
+
+        if (result.error) {
+          error(result.error);
+        }
+
+        process.exit(result.status);
+      })
+      .catch((e) => {
+        error(e.message);
+        process.exit(1);
+      });
+  }
+}
+
+module.exports.Package = Package;