claude_code_slash_commands 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c210edb72d63d4cdb518fb644dae19bad1f8b78fce946896832949dcf2b15a12
-  data.tar.gz: bd4a22abcae98bb843b902eee41eeeafc9575ec9dd8d127b03e4abe5b146afc6
+  metadata.gz: 89ca4fe43efd662a0ead8fbc2638980bf11b1c087e1c67d2c8b8294e75af34b5
+  data.tar.gz: 7f137f9800fda4559099125496339ad688add88e40ff5ab4562434c9265d5679
 SHA512:
-  metadata.gz: f994df51e9893d1a0bc8b37481470bf04846ff7ed5fac3a9ed1b9fbd0e8f7c005177a0d27dfd7a5575e7a5cd0e11a2b7c33c26204eeb86f1f3c59905d00397d5
-  data.tar.gz: a23b39eef771857dfff527f9ff070341e625051e70940b0380b57c7f3fac9cf0964cb5337e9a06a709c35b8dcf69035dce3c7b8b52625df14cc6974830c8d3de
+  metadata.gz: 39e56a72e6087ea9388136c7c8fda53af496a5a8cbafcd76f57e3abb8b3d40997a345562b81719ccd4260320fbbfc24dfafbcfa75eb651ad31b11d4f9e20d8b1
+  data.tar.gz: 48db40cc5f04f83e8cea64ce05149306c6584391bb3ba4275ed1b9e73a08324b55274469bd660b79117a5cd4a6e3bea93a036866b1cfc8b0f2d80c93aa8368da

data/CLAUDE.md

@@ -0,0 +1,57 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+### Testing and Development
+- `rake test` - Run the test suite using Minitest
+- `bundle exec rake test` - Run tests with bundler
+- `rake standard` - Run StandardRB linter for code formatting
+- `rake standard:fix` - Auto-fix StandardRB formatting issues
+- `rake` - Run default task (both tests and linting)
+
+### Gem Development
+- `bundle exec rake install` - Install gem locally for testing
+- `bundle exec rake release` - Create git tag and push to RubyGems
+- `bundle exec rake build` - Build the gem file
+- `bin/setup` - Install dependencies after checkout
+- `bin/console` - Start interactive console with gem loaded
+
+### CLI Usage
+- `claude_code_slash_commands install` - Install commands to ~/.claude/commands from GitHub
+- `claude_code_slash_commands install --local` - Install commands from local commands/ directory
+- `claude_code_slash_commands help` - Show help message
+
+## Architecture
+
+This is a Ruby gem that distributes slash commands for Claude Code. The main components are:
+
+### Core Structure
+- `ClaudeCodeSlashCommands::CLI` - Command-line interface handler that processes user commands
+- `ClaudeCodeSlashCommands::Installer` - Handles downloading and installing command files from GitHub to `~/.claude/commands`
+- `commands/` directory - Contains the actual slash command markdown files that get distributed
+
+### Key Features
+- **GitHub Integration**: Uses `gh` CLI to fetch command files directly from the repository
+- **Smart Installation**: Compares file contents to avoid unnecessary overwrites, prompts for confirmation when files differ
+- **Command Format**: Slash commands are markdown files with optional YAML frontmatter for metadata
+
+### Dependencies
+- Requires GitHub CLI (`gh`) to be installed and configured
+- Uses StandardRB for code formatting
+- Minitest for testing framework
+- Mocha for test mocking
+
+### Command File Structure
+Slash commands are stored as `.md` files in the `commands/` directory with this format:
+```markdown
+---
+description: Brief description of the command
+allowed-tools: Bash(git status:*)
+---
+
+Command prompt content goes here
+```
+
+The installer fetches these files from GitHub and copies them to the user's `~/.claude/commands` directory.

data/Gemfile

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in claude_code_slash_commands.gemspec
+gemspec
+
+gem "irb"
+gem "rake", "~> 13.0"
+
+gem "minitest", "~> 5.16"
+gem "mocha"
+
+gem "standard", "~> 1.3"

data/Gemfile.lock

@@ -0,0 +1,93 @@
+PATH
+  remote: .
+  specs:
+    claude_code_slash_commands (0.2.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.3)
+    date (3.4.1)
+    erb (5.0.1)
+    io-console (0.8.0)
+    irb (1.15.2)
+      pp (>= 0.6.0)
+      rdoc (>= 4.0.0)
+      reline (>= 0.4.2)
+    json (2.12.2)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    minitest (5.25.5)
+    mocha (2.7.1)
+      ruby2_keywords (>= 0.0.5)
+    parallel (1.27.0)
+    parser (3.3.8.0)
+      ast (~> 2.4.1)
+      racc
+    pp (0.6.2)
+      prettyprint
+    prettyprint (0.2.0)
+    prism (1.4.0)
+    psych (5.2.6)
+      date
+      stringio
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.3.0)
+    rdoc (6.14.2)
+      erb
+      psych (>= 4.0.0)
+    regexp_parser (2.10.0)
+    reline (0.6.1)
+      io-console (~> 0.5)
+    rubocop (1.75.8)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.44.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.45.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-performance (1.25.0)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+    ruby-progressbar (1.13.0)
+    ruby2_keywords (0.0.5)
+    standard (1.50.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.75.5)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.8)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.8.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.25.0)
+    stringio (3.1.7)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
+
+PLATFORMS
+  arm64-darwin-24
+  ruby
+
+DEPENDENCIES
+  claude_code_slash_commands!
+  irb
+  minitest (~> 5.16)
+  mocha
+  rake (~> 13.0)
+  standard (~> 1.3)
+
+BUNDLED WITH
+   2.6.9

data/README.md

@@ -1,6 +1,10 @@
 # claude_code_slash_commands
 
-This gem is intended to distribute [slash commands](https://docs.anthropic.com/en/docs/claude-code/slash-commands) for [Claude Code](https://www.anthropic.com/claude-code).
+This gem is for distributing Ruby-specific [slash commands](https://docs.anthropic.com/en/docs/claude-code/slash-commands) for [Claude Code](https://www.anthropic.com/claude-code).
+
+## Prerequisites
+
+The [GitHub CLI](https://cli.github.com) must be installed and configured.
 
 ## Installation
 
@@ -29,14 +33,28 @@ claude_code_slash_commands install
 ```
 
 This will:
-- Create `~/.claude/commands` directory if it doesn't exist
-- Copy all command files from the gem
+- Create the `~/.claude/commands` directory if it doesn't exist
+- Copy all command files from the `commands/` directory on GitHub to your local `~/.claude/commands` directory.
 - Ask for confirmation before overwriting existing commands
 - Skip files that are already identical
 
+#### Local Installation
+
+By default, commands will be fetched from the gem's GitHub repository. That means you'll always get the latest versions.
+
+To install commands from the gem's `commands/` directory instead of GitHub:
+
+```bash
+claude_code_slash_commands install --local
+```
+
+This is useful for:
+- Testing new commands during development
+- Installing commands when you don't have internet access
+
 ### Available Commands
 
-- `hello_world.md` - A simple example command that demonstrates the slash command format
+Check the `commands/` directory to see what is available.
 
 ## Development
 

data/commands/configure-gem-ci.md

@@ -0,0 +1,10 @@
+---
+description: Configure a gem's CI pipeline using GitHub Actions
+---
+The goal is to create a CI workflow file that runs the gem's tests as well as any linting or other verificiation tasks.
+
+If no CI workflow file exists, create one, otherwise update the existing one.
+
+ Read https://www.ruby-lang.org/en/downloads/branches/ to check the latest Ruby release version.
+
+Configure the CI matrix such that it covers the the minimum `required_ruby_version` in the `.gemspec`, as well as every minor release up to the latest Ruby version.

data/lib/claude_code_slash_commands/cli.rb

@@ -15,7 +15,8 @@ module ClaudeCodeSlashCommands
     def run
       case @args.first
       when "install"
-        Installer.new.install
+        local = @args.include?("--local")
+        Installer.new(local: local).install
       when "help", "-h", "--help", nil
         show_help
       else
@@ -29,14 +30,18 @@ module ClaudeCodeSlashCommands
 
     def show_help
       puts <<~HELP
-        Usage: claude_code_slash_commands <command>
+        Usage: claude_code_slash_commands <command> [options]
 
         Commands:
           install    Install slash commands to ~/.claude/commands
           help       Show this help message
 
+        Options:
+          --local    Install from local commands/ directory instead of GitHub
+
         Examples:
           claude_code_slash_commands install
+          claude_code_slash_commands install --local
           claude_code_slash_commands help
       HELP
     end

data/lib/claude_code_slash_commands/installer.rb

@@ -2,25 +2,42 @@
 
 require "fileutils"
 require "pathname"
+require "json"
+require "open3"
 
 module ClaudeCodeSlashCommands
   class Installer
-    def initialize(commands_source: nil, commands_target: nil)
+    def initialize(commands_source: nil, commands_target: nil, repo: nil, local: false)
       @gem_root = Pathname.new(__dir__).parent.parent
       @commands_source = commands_source || @gem_root.join("commands")
       @commands_target = commands_target || Pathname.new(Dir.home).join(".claude", "commands")
+      @repo = repo || "andyw8/claude_code_slash_commands"
+      @local = local
     end
 
     def install
       ensure_target_directory
 
-      if command_files.empty?
-        puts "❌ No command files found to install"
-        return
-      end
+      if @local
+        commands = fetch_commands_from_local
+        if commands.empty?
+          puts "❌ No command files found in local commands/ directory"
+          return
+        end
+
+        commands.each do |command_file|
+          install_command_from_local(command_file)
+        end
+      else
+        commands = fetch_commands_from_github
+        if commands.empty?
+          puts "❌ No command files found to install"
+          return
+        end
 
-      command_files.each do |file|
-        install_command(file)
+        commands.each do |command|
+          install_command_from_github(command)
+        end
       end
 
       puts "✅ Installation complete!"
@@ -35,31 +52,44 @@ module ClaudeCodeSlashCommands
       FileUtils.mkdir_p(@commands_target)
     end
 
-    def command_files
-      @commands_source.glob("*.md")
+    def fetch_commands_from_github
+      stdout, stderr, status = Open3.capture3("gh", "api", "repos/#{@repo}/contents/commands")
+
+      unless status.success?
+        raise "Failed to fetch commands from GitHub: #{stderr}"
+      end
+
+      contents = JSON.parse(stdout)
+      contents.select { |item| item["type"] == "file" && item["name"].end_with?(".md") }
     end
 
-    def install_command(source_file)
-      target_file = @commands_target.join(source_file.basename)
+    def install_command_from_github(command)
+      filename = command["name"]
+      target_file = @commands_target.join(filename)
+
+      # Fetch the content of the command file
+      stdout, stderr, status = Open3.capture3("gh", "api", command["download_path"])
+
+      unless status.success?
+        raise "Failed to fetch command content for #{filename}: #{stderr}"
+      end
+
+      content = stdout
 
       if target_file.exist?
-        if files_identical?(source_file, target_file)
-          puts "⏭️  #{source_file.basename} already exists and is identical"
+        if target_file.read == content
+          puts "⏭️  #{filename} already exists and is identical"
           return
         end
 
-        unless confirm_overwrite(source_file.basename)
-          puts "⏭️  Skipping #{source_file.basename}"
+        unless confirm_overwrite(filename)
+          puts "⏭️  Skipping #{filename}"
           return
         end
       end
 
-      FileUtils.cp(source_file, target_file)
-      puts "📄 Installed #{source_file.basename}"
-    end
-
-    def files_identical?(file1, file2)
-      file1.read == file2.read
+      target_file.write(content)
+      puts "📄 Installed #{filename}"
     end
 
     def confirm_overwrite(filename)
@@ -67,5 +97,33 @@ module ClaudeCodeSlashCommands
       response = $stdin.gets.chomp.downcase
       response == "y" || response == "yes"
     end
+
+    def fetch_commands_from_local
+      return [] unless @commands_source.exist?
+
+      @commands_source.glob("*.md").select(&:file?)
+    end
+
+    def install_command_from_local(command_file)
+      filename = command_file.basename.to_s
+      target_file = @commands_target.join(filename)
+
+      content = command_file.read
+
+      if target_file.exist?
+        if target_file.read == content
+          puts "⏭️  #{filename} already exists and is identical"
+          return
+        end
+
+        unless confirm_overwrite(filename)
+          puts "⏭️  Skipping #{filename}"
+          return
+        end
+      end
+
+      target_file.write(content)
+      puts "📄 Installed #{filename}"
+    end
   end
 end

data/lib/claude_code_slash_commands/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ClaudeCodeSlashCommands
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: claude_code_slash_commands
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Andy Waite
@@ -18,10 +18,13 @@ extra_rdoc_files: []
 files:
 - ".ruby-version"
 - ".standard.yml"
+- CLAUDE.md
+- Gemfile
+- Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
-- commands/hello_world.md
+- commands/configure-gem-ci.md
 - exe/claude_code_slash_commands
 - lib/claude_code_slash_commands.rb
 - lib/claude_code_slash_commands/cli.rb
@@ -42,7 +45,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/commands/hello_world.md

@@ -1,7 +0,0 @@
----
-description: A simple hello world example command
----
-
-Say hello to the world! This is an example slash command that demonstrates the basic structure of a Claude Code slash command.
-
-Respond with a friendly greeting and explain what slash commands are.