all_in_ruby 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4e016ce2d0604883066cae2f675273dc7a239291bcd591324e15eafcc3a2ced8
+  data.tar.gz: ed253dfd0c43ee7ee7e2c40546639500b50b2aa3bf97c548d5788386adddcc0a
+SHA512:
+  metadata.gz: 46e170a80461bbcdde8c26c73e81e479954199fe2332937f1a5aff96a76de3f33e9db9104440576ec23945a3cef658b018ee5b642a9bb55cd478fad7d3056144
+  data.tar.gz: 73e95dfb8c32a8ac29e5fa839d0deac2728d57f4d04ed15087f27df3878a371561cd9f55368a37c99f24dd6371a7e38950c7c9b0bed4cda9ebedafe3bbffa9b3

data/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 0.1.0 (2026-07-20)
+
+- First release
+- `install`, `uninstall`, and `status` commands
+- Supports Claude Code (`CLAUDE.md`) and Codex (`AGENTS.md`), local and global scopes

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Lucian Ghinda
+
+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,94 @@
+# all_in_ruby
+
+Tell your AI coding agents to write scripts in Ruby.
+
+Adds a "write throwaway and utility scripts in Ruby" instruction to agent instruction files - `CLAUDE.md` for Claude Code, `AGENTS.md` for Codex. Additive and idempotent: your existing instructions are never modified.
+
+## Installation
+
+```sh
+gem install all_in_ruby
+```
+
+## Quick Start
+
+Add the instruction to the current repo:
+
+```sh
+all-in-ruby install
+```
+
+Or add it globally, for every project:
+
+```sh
+all-in-ruby install --global
+```
+
+This writes to `~/.claude/CLAUDE.md` and `~/.codex/AGENTS.md`. If `CODEX_HOME` is set, it is used instead of `~/.codex`, matching Codex's own resolution.
+
+## Usage
+
+Target a single agent:
+
+```sh
+all-in-ruby install --claude
+all-in-ruby install --codex
+```
+
+Check where the instruction is installed:
+
+```sh
+all-in-ruby status
+```
+
+Remove it:
+
+```sh
+all-in-ruby uninstall
+```
+
+## How It Works
+
+The instruction is appended inside marker comments:
+
+```markdown
+<!-- BEGIN all_in_ruby -->
+## Scripts
+
+Write throwaway and utility scripts (data munging, one-off migrations,
+file renames, glue code) in Ruby — even in projects written in another
+language. If it needs a pipe, a loop, a conditional, or more than one
+line, it is a script: write it in Ruby, not Python, Node, or bash.
+Single self-contained commands (`grep`, `git status`) are fine as-is.
+
+Use only the Ruby standard library. If a gem would clearly save
+significant effort, stop and ask before using it.
+
+Put temporary scripts in a scratch or temp directory, not the repo
+root, and delete them when done unless asked to keep them.
+<!-- END all_in_ruby -->
+```
+
+Existing file content is preserved verbatim. Running `install` twice is a no-op. `uninstall` removes only the marked block.
+
+## History
+
+View the [changelog](CHANGELOG.md)
+
+## Contributing
+
+Everyone is encouraged to help improve this project. Here are a few ways you can help:
+
+- [Report bugs](https://github.com/lucianghinda/all-in-ruby/issues)
+- Fix bugs and [submit pull requests](https://github.com/lucianghinda/all-in-ruby/pulls)
+- Write, clarify, or fix documentation
+- Suggest or add new features
+
+To get started with development:
+
+```sh
+git clone https://github.com/lucianghinda/all-in-ruby.git
+cd all-in-ruby
+bundle install
+bundle exec rake test
+```

data/exe/all-in-ruby

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require "all_in_ruby"
+
+exit AllInRuby::CLI.new.run(ARGV)

data/lib/all_in_ruby/cli.rb

@@ -0,0 +1,78 @@
+require "optparse"
+
+module AllInRuby
+  class CLI
+    COMMANDS = ["install", "uninstall", "status"].freeze
+
+    STATUS_LABELS = {
+      created: "created",
+      updated: "instructions added",
+      already_installed: "already installed, left untouched",
+      removed: "instructions removed",
+      not_installed: "not installed",
+      installed: "installed"
+    }.freeze
+
+    def initialize(stdout: $stdout, stderr: $stderr, installer: Installer.new)
+      @stdout = stdout
+      @stderr = stderr
+      @installer = installer
+    end
+
+    def run(argv)
+      options = {agents: Installer::AGENTS.dup, scope: "local"}
+      parser = build_parser(options)
+      parser.parse!(argv)
+
+      command = argv.shift
+      unless COMMANDS.include?(command)
+        @stderr.puts parser
+        return 1
+      end
+
+      results = @installer.public_send(command, agents: options[:agents], scope: options[:scope])
+      results.each do |result|
+        @stdout.puts "#{result.agent.ljust(6)} #{result.path}: #{STATUS_LABELS.fetch(result.status)}"
+      end
+      0
+    rescue OptionParser::ParseError => e
+      @stderr.puts e.message
+      1
+    end
+
+    private
+
+    def build_parser(options)
+      OptionParser.new do |opts|
+        opts.banner = <<~BANNER
+          Usage: all-in-ruby COMMAND [options]
+
+          Adds a "write scripts in Ruby" instruction to AI agent instruction
+          files (CLAUDE.md for Claude Code, AGENTS.md for Codex). Additive and
+          idempotent: existing content is never modified.
+
+          Commands:
+              install      add the instruction block
+              uninstall    remove the instruction block
+              status       show where the block is installed
+
+          Options:
+        BANNER
+
+        opts.on("--global", "Target global files (~/.claude/CLAUDE.md, ~/.codex/AGENTS.md)") do
+          options[:scope] = "global"
+        end
+        opts.on("--claude", "Only Claude Code (CLAUDE.md)") do
+          options[:agents] = ["claude"]
+        end
+        opts.on("--codex", "Only Codex (AGENTS.md)") do
+          options[:agents] = ["codex"]
+        end
+        opts.on("-v", "--version", "Print version") do
+          @stdout.puts VERSION
+          exit 0
+        end
+      end
+    end
+  end
+end

data/lib/all_in_ruby/installer.rb

@@ -0,0 +1,80 @@
+require "fileutils"
+
+module AllInRuby
+  class Installer
+    AGENTS = ["claude", "codex"].freeze
+    SCOPES = ["local", "global"].freeze
+
+    Result = Struct.new(:agent, :path, :status)
+
+    def initialize(root: Dir.pwd, home: Dir.home, env: ENV)
+      @root = root
+      @home = home
+      @env = env
+    end
+
+    def path_for(agent, scope)
+      case [agent, scope]
+      when ["claude", "local"] then File.join(@root, "CLAUDE.md")
+      when ["claude", "global"] then File.join(@home, ".claude", "CLAUDE.md")
+      when ["codex", "local"] then File.join(@root, "AGENTS.md")
+      when ["codex", "global"] then File.join(codex_home, "AGENTS.md")
+      else
+        raise ArgumentError, "unknown agent or scope: #{agent}, #{scope}"
+      end
+    end
+
+    def install(agents:, scope:)
+      each_target(agents, scope) do |path|
+        content = File.exist?(path) ? File.read(path) : nil
+
+        if content && Instruction.installed?(content)
+          :already_installed
+        elsif content
+          separator = content.empty? || content.end_with?("\n\n") ? "" : (content.end_with?("\n") ? "\n" : "\n\n")
+          File.write(path, content + separator + Instruction.block)
+          :updated
+        else
+          FileUtils.mkdir_p(File.dirname(path))
+          File.write(path, Instruction.block)
+          :created
+        end
+      end
+    end
+
+    def uninstall(agents:, scope:)
+      each_target(agents, scope) do |path|
+        content = File.exist?(path) ? File.read(path) : nil
+
+        if content && Instruction.installed?(content)
+          File.write(path, Instruction.remove(content))
+          :removed
+        else
+          :not_installed
+        end
+      end
+    end
+
+    def status(agents:, scope:)
+      each_target(agents, scope) do |path|
+        content = File.exist?(path) ? File.read(path) : nil
+        content && Instruction.installed?(content) ? :installed : :not_installed
+      end
+    end
+
+    private
+
+    # Codex resolves its home from $CODEX_HOME, defaulting to ~/.codex
+    def codex_home
+      codex_home = @env["CODEX_HOME"]
+      codex_home && !codex_home.empty? ? codex_home : File.join(@home, ".codex")
+    end
+
+    def each_target(agents, scope)
+      agents.map do |agent|
+        path = path_for(agent, scope)
+        Result.new(agent, path, yield(path))
+      end
+    end
+  end
+end

data/lib/all_in_ruby/instruction.rb

@@ -0,0 +1,36 @@
+module AllInRuby
+  module Instruction
+    BEGIN_MARKER = "<!-- BEGIN all_in_ruby -->".freeze
+    END_MARKER = "<!-- END all_in_ruby -->".freeze
+
+    BODY = <<~MARKDOWN.freeze
+      ## Scripts
+
+      Write throwaway and utility scripts (data munging, one-off migrations,
+      file renames, glue code) in Ruby — even in projects written in another
+      language. If it needs a pipe, a loop, a conditional, or more than one
+      line, it is a script: write it in Ruby, not Python, Node, or bash.
+      Single self-contained commands (`grep`, `git status`) are fine as-is.
+
+      Use only the Ruby standard library. If a gem would clearly save
+      significant effort, stop and ask before using it.
+
+      Put temporary scripts in a scratch or temp directory, not the repo
+      root, and delete them when done unless asked to keep them.
+    MARKDOWN
+
+    BLOCK = "#{BEGIN_MARKER}\n#{BODY}#{END_MARKER}\n".freeze
+
+    def self.block
+      BLOCK
+    end
+
+    def self.installed?(content)
+      content.include?(BEGIN_MARKER)
+    end
+
+    def self.remove(content)
+      content.gsub(/\n?#{Regexp.escape(BEGIN_MARKER)}.*?#{Regexp.escape(END_MARKER)}\n?/m, "\n")
+    end
+  end
+end

data/lib/all_in_ruby/version.rb

@@ -0,0 +1,3 @@
+module AllInRuby
+  VERSION = "0.1.0"
+end

data/lib/all_in_ruby.rb

@@ -0,0 +1,8 @@
+require_relative "all_in_ruby/version"
+require_relative "all_in_ruby/instruction"
+require_relative "all_in_ruby/installer"
+require_relative "all_in_ruby/cli"
+
+module AllInRuby
+  class Error < StandardError; end
+end

metadata

@@ -0,0 +1,61 @@
+--- !ruby/object:Gem::Specification
+name: all_in_ruby
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Lucian Ghinda
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: Adds a 'write throwaway and utility scripts in Ruby' instruction to AI
+  agent instruction files (CLAUDE.md for Claude Code, AGENTS.md for Codex), locally
+  or globally. Additive and idempotent.
+email: dev@ghinda.com
+executables:
+- all-in-ruby
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- exe/all-in-ruby
+- lib/all_in_ruby.rb
+- lib/all_in_ruby/cli.rb
+- lib/all_in_ruby/installer.rb
+- lib/all_in_ruby/instruction.rb
+- lib/all_in_ruby/version.rb
+homepage: https://github.com/lucianghinda/all-in-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/lucianghinda/all-in-ruby
+  source_code_uri: https://github.com/lucianghinda/all-in-ruby
+  changelog_uri: https://github.com/lucianghinda/all-in-ruby/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/lucianghinda/all-in-ruby/issues
+  rubygems_mfa_required: 'true'
+post_install_message: |
+  all_in_ruby installed. To add the Ruby-first instruction to your agents, run:
+
+    all-in-ruby install            # CLAUDE.md + AGENTS.md in the current repo
+    all-in-ruby install --global   # ~/.claude/CLAUDE.md + ~/.codex/AGENTS.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: Tell your AI coding agents to write scripts in Ruby
+test_files: []