claude_code_slash_commands 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c210edb72d63d4cdb518fb644dae19bad1f8b78fce946896832949dcf2b15a12
+  data.tar.gz: bd4a22abcae98bb843b902eee41eeeafc9575ec9dd8d127b03e4abe5b146afc6
+SHA512:
+  metadata.gz: f994df51e9893d1a0bc8b37481470bf04846ff7ed5fac3a9ed1b9fbd0e8f7c005177a0d27dfd7a5575e7a5cd0e11a2b7c33c26204eeb86f1f3c59905d00397d5
+  data.tar.gz: a23b39eef771857dfff527f9ff070341e625051e70940b0380b57c7f3fac9cf0964cb5337e9a06a709c35b8dcf69035dce3c7b8b52625df14cc6974830c8d3de

data/.ruby-version

@@ -0,0 +1 @@
+3.4.4

data/.standard.yml

@@ -0,0 +1,3 @@
+# For available configuration options, see:
+#   https://github.com/standardrb/standard
+ruby_version: 3.1

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Andy Waite
+
+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.

data/README.md

@@ -0,0 +1,72 @@
+# 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).
+
+## Installation
+
+Install the gem and add to the application's Gemfile by executing:
+
+```bash
+bundle add claude_code_slash_commands
+```
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+```bash
+gem install claude_code_slash_commands
+```
+
+## Usage
+
+This gem provides a tool to distribute custom slash commands for Claude Code.
+
+### Installing Commands
+
+To install the included slash commands to your `~/.claude/commands` directory:
+
+```bash
+claude_code_slash_commands install
+```
+
+This will:
+- Create `~/.claude/commands` directory if it doesn't exist
+- Copy all command files from the gem
+- Ask for confirmation before overwriting existing commands
+- Skip files that are already identical
+
+### Available Commands
+
+- `hello_world.md` - A simple example command that demonstrates the slash command format
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/andyw8/claude_code_slash_commands.
+
+### Adding Your Own Commands
+
+To add your own commands to this gem:
+
+1. Create `.md` files in the `commands/` directory
+2. Use YAML frontmatter for metadata (optional)
+3. Write the command prompt in the file content
+
+Example command format:
+```markdown
+---
+description: Brief description of the command
+allowed-tools: Bash(git status:*)
+---
+
+Your command prompt goes here. This text will be used as the instruction
+when the slash command is invoked.
+```
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+require "standard/rake"
+
+task default: %i[test standard]

data/commands/hello_world.md

@@ -0,0 +1,7 @@
+---
+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.

data/exe/claude_code_slash_commands

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "claude_code_slash_commands"
+
+ClaudeCodeSlashCommands::CLI.start(ARGV)

data/lib/claude_code_slash_commands/cli.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require_relative "installer"
+
+module ClaudeCodeSlashCommands
+  class CLI
+    def self.start(args)
+      new(args).run
+    end
+
+    def initialize(args)
+      @args = args
+    end
+
+    def run
+      case @args.first
+      when "install"
+        Installer.new.install
+      when "help", "-h", "--help", nil
+        show_help
+      else
+        puts "Unknown command: #{@args.first}"
+        show_help
+        exit(1)
+      end
+    end
+
+    private
+
+    def show_help
+      puts <<~HELP
+        Usage: claude_code_slash_commands <command>
+
+        Commands:
+          install    Install slash commands to ~/.claude/commands
+          help       Show this help message
+
+        Examples:
+          claude_code_slash_commands install
+          claude_code_slash_commands help
+      HELP
+    end
+  end
+end

data/lib/claude_code_slash_commands/installer.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "pathname"
+
+module ClaudeCodeSlashCommands
+  class Installer
+    def initialize(commands_source: nil, commands_target: nil)
+      @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")
+    end
+
+    def install
+      ensure_target_directory
+
+      if command_files.empty?
+        puts "❌ No command files found to install"
+        return
+      end
+
+      command_files.each do |file|
+        install_command(file)
+      end
+
+      puts "✅ Installation complete!"
+    rescue => e
+      puts "❌ Installation failed: #{e.message}"
+      exit(1)
+    end
+
+    private
+
+    def ensure_target_directory
+      FileUtils.mkdir_p(@commands_target)
+    end
+
+    def command_files
+      @commands_source.glob("*.md")
+    end
+
+    def install_command(source_file)
+      target_file = @commands_target.join(source_file.basename)
+
+      if target_file.exist?
+        if files_identical?(source_file, target_file)
+          puts "⏭️  #{source_file.basename} already exists and is identical"
+          return
+        end
+
+        unless confirm_overwrite(source_file.basename)
+          puts "⏭️  Skipping #{source_file.basename}"
+          return
+        end
+      end
+
+      FileUtils.cp(source_file, target_file)
+      puts "📄 Installed #{source_file.basename}"
+    end
+
+    def files_identical?(file1, file2)
+      file1.read == file2.read
+    end
+
+    def confirm_overwrite(filename)
+      print "❓ #{filename} already exists. Overwrite? (y/N): "
+      response = $stdin.gets.chomp.downcase
+      response == "y" || response == "yes"
+    end
+  end
+end

data/lib/claude_code_slash_commands/version.rb

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

data/lib/claude_code_slash_commands.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative "claude_code_slash_commands/version"
+require_relative "claude_code_slash_commands/cli"
+
+module ClaudeCodeSlashCommands
+  class Error < StandardError; end
+end

data/sig/claude_code_slash_commands.rbs

@@ -0,0 +1,4 @@
+module ClaudeCodeSlashCommands
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification
+name: claude_code_slash_commands
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Andy Waite
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+email:
+- 13400+andyw8@users.noreply.github.com
+executables:
+- claude_code_slash_commands
+extensions: []
+extra_rdoc_files: []
+files:
+- ".ruby-version"
+- ".standard.yml"
+- LICENSE.txt
+- README.md
+- Rakefile
+- commands/hello_world.md
+- exe/claude_code_slash_commands
+- lib/claude_code_slash_commands.rb
+- lib/claude_code_slash_commands/cli.rb
+- lib/claude_code_slash_commands/installer.rb
+- lib/claude_code_slash_commands/version.rb
+- sig/claude_code_slash_commands.rbs
+homepage: https://github.com/andyw8/claude_code_slash_commands
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/andyw8/claude_code_slash_commands
+  source_code_uri: https://github.com/andyw8/claude_code_slash_commands
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: A tool for distributing Claude Code slash commands.
+test_files: []