tailgrab 1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a55734bb8ed595c37416cd8193218baf59c33031b0e08be308d63ee55d26aeb3
+  data.tar.gz: 5787a353f6a1a69865e566fb1a111e8a2fd5414b5b1627a03fd5ee951a525d64
+SHA512:
+  metadata.gz: 998130391a27e5d839a4af4ae3ff4a2c95b45f01bfdc67f3bf6ed394edd77899f598109b730532adc00431680ac3fb91c916a8623c34ee534ff54e3ecc2cc1c6
+  data.tar.gz: a3b4e419e798cfe3d13e94012430c2c3156f27697d893251995842ede1d2bfcfe209dae1d47a9ea80ab38f2c2ced188afe494bfee6a963ee50b18a995e891824

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,23 @@
+AllCops:
+  NewCops: enable
+  TargetRubyVersion: 3.0
+  SuggestExtensions: false
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+Style/Documentation:
+  Enabled: false
+
+Metrics/BlockLength:
+  Exclude:
+    - "spec/**/*"
+
+Metrics/MethodLength:
+  Max: 15
+
+Metrics/ClassLength:
+  Max: 125

data/CHANGELOG.md

@@ -0,0 +1,18 @@
+## [1.0] - 2026-02-28
+
+- Complete rewrite of the CLI tool
+- `grab N` saves last N commands from shell history with timestamps
+- `grab last` copies last saved command to clipboard
+- `grab last N` prints last N saved commands
+- `grab all` prints all saved commands
+- `grab day` shows commands saved in last 24 hours
+- `grab wipe` clears all saved commands
+- `grab help` shows usage information
+- Cross-platform clipboard support (pbcopy, wl-copy, xclip, xsel)
+- Reads zsh and bash history files directly
+- Color-coded output with TTY detection
+- Zero runtime dependencies
+
+## [0.1.0] - 2024-12-13
+
+- Initial release

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 Himanshu Panwar
+
+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,44 @@
+# Tailgrab
+
+A CLI tool that reads your shell history (zsh/bash), saves commands to a local file
+with timestamps, and lets you recall, filter, or copy them to your clipboard.
+
+## Install
+
+```
+gem install tailgrab
+```
+
+## Usage
+
+```
+grab 5          # Save last 5 commands from shell history
+grab last       # Copy last saved command to clipboard
+grab last 3     # Show last 3 saved commands
+grab all        # Show all saved commands
+grab day        # Show commands saved in the last 24 hours
+grab wipe       # Clear all saved commands
+grab help       # Show help
+```
+
+Commands are saved to `~/tailgrab.txt` with timestamps.
+
+## Shell Setup
+
+For best results with multiple terminals, add to your `~/.zshrc`:
+
+```
+setopt INC_APPEND_HISTORY
+```
+
+## Development
+
+```
+bundle install
+bundle exec rake        # runs specs + rubocop
+bundle exec rake install  # install locally
+```
+
+## License
+
+MIT

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/bin/grab

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "tailgrab"
+
+Tailgrab::CLI.new(ARGV).run

data/lib/tailgrab/cli.rb

@@ -0,0 +1,131 @@
+# frozen_string_literal: true
+
+module Tailgrab
+  class CLI
+    COMMANDS = %w[help last all day wipe].freeze
+    HELP_TEXT = <<~HELP
+      Tailgrab — Save and recall your terminal commands
+
+      Usage:
+        grab N          Save last N commands from shell history
+        grab last       Copy last saved command to clipboard
+        grab last N     Show last N saved commands (N=1 copies to clipboard)
+        grab all        Show all saved commands
+        grab day        Show commands saved in the last 24 hours
+        grab wipe       Clear all saved commands
+        grab help       Show this help message
+
+      Examples:
+        grab 5          Save your last 5 terminal commands
+        grab last 3     Show the 3 most recently saved commands
+        grab last       Copy the most recent saved command to clipboard
+
+      Tip: Add 'setopt INC_APPEND_HISTORY' to ~/.zshrc so commands from
+      all open terminals are available immediately.
+
+      File: ~/tailgrab.txt
+    HELP
+
+    def initialize(args, storage: Storage.new, history_reader: HistoryReader.new)
+      @args = args
+      @storage = storage
+      @history_reader = history_reader
+    end
+
+    def run
+      command = @args[0]
+
+      if command.nil? || command == "help"
+        print_help
+      elsif COMMANDS.include?(command)
+        send("handle_#{command}")
+      elsif command.match?(/\A\d+\z/)
+        handle_save(command.to_i)
+      else
+        puts "Unknown command: #{command}\n\n"
+        print_help
+      end
+    end
+
+    private
+
+    def handle_save(count)
+      return puts("Please provide a positive number.") if count < 1
+
+      commands = @history_reader.last(count)
+      return puts("No shell history found. Is your history file accessible?") if commands.empty?
+
+      @storage.save(commands)
+      noun = commands.length == 1 ? "command" : "commands"
+      puts "Saved #{commands.length} #{noun} to #{@storage.file_path}"
+    end
+
+    def handle_last
+      count = parse_last_count
+      return if count.nil?
+
+      entries = @storage.read_last(count)
+      return puts("No saved commands yet. Run 'grab N' to save some.") if entries.empty?
+
+      count == 1 ? copy_to_clipboard(entries.last) : print_entries("Last #{entries.length} saved commands:", entries)
+    end
+
+    def handle_day
+      entries = @storage.read_since(Time.now - 86_400)
+      return puts("No commands saved in the last 24 hours.") if entries.empty?
+
+      print_entries("Commands saved in the last 24 hours:", entries)
+    end
+
+    def handle_all
+      entries = @storage.read_all
+      return puts("No saved commands yet. Run 'grab N' to save some.") if entries.empty?
+
+      print_entries("All saved commands (#{entries.length}):", entries)
+    end
+
+    def handle_wipe
+      @storage.wipe
+      puts "All saved commands have been cleared."
+    end
+
+    def parse_last_count
+      raw = @args[1]
+      return 1 if raw.nil?
+      return puts("Invalid number: #{raw}") unless raw.match?(/\A\d+\z/)
+
+      count = raw.to_i
+      return puts("Please provide a positive number.") if count < 1
+
+      count
+    end
+
+    def copy_to_clipboard(entry)
+      command = @storage.extract_command(entry)
+      if Clipboard.copy(command)
+        puts "Copied to clipboard: #{command}"
+      else
+        puts command
+        puts "(clipboard not available — install pbcopy, xclip, or xsel)"
+      end
+    end
+
+    def print_entries(header, entries)
+      puts header
+      entries.each_with_index do |entry, idx|
+        puts "  #{Colors.cyan("#{idx + 1}.")} #{format_entry(entry)}"
+      end
+    end
+
+    def format_entry(entry)
+      match = entry.match(Storage::ENTRY_PATTERN)
+      return entry unless match
+
+      "#{Colors.dim(match[1])} #{Colors.dim("|")} #{Colors.bold(match[2])}"
+    end
+
+    def print_help
+      puts HELP_TEXT
+    end
+  end
+end

data/lib/tailgrab/clipboard.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Tailgrab
+  class Clipboard
+    class << self
+      def copy(text)
+        cmd = clipboard_command
+        return false unless cmd
+
+        IO.popen(cmd, "w") { |io| io.write(text) }
+        true
+      rescue Errno::ENOENT, IOError
+        false
+      end
+
+      def available?
+        !clipboard_command.nil?
+      end
+
+      private
+
+      def clipboard_command
+        @clipboard_command ||= detect_clipboard_command
+      end
+
+      def detect_clipboard_command
+        if command_exists?("pbcopy")
+          "pbcopy"
+        elsif command_exists?("wl-copy")
+          "wl-copy"
+        elsif command_exists?("xclip")
+          "xclip -selection clipboard"
+        elsif command_exists?("xsel")
+          "xsel --clipboard --input"
+        end
+      end
+
+      def command_exists?(cmd)
+        system("which #{cmd} > /dev/null 2>&1")
+      end
+    end
+  end
+end

data/lib/tailgrab/colors.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Tailgrab
+  module Colors
+    CODES = {
+      reset: "\e[0m",
+      bold: "\e[1m",
+      dim: "\e[2m",
+      cyan: "\e[36m"
+    }.freeze
+
+    module_function
+
+    def enabled?
+      $stdout.tty?
+    end
+
+    def cyan(text)
+      wrap(text, :cyan)
+    end
+
+    def bold(text)
+      wrap(text, :bold)
+    end
+
+    def dim(text)
+      wrap(text, :dim)
+    end
+
+    def wrap(text, code)
+      return text unless enabled?
+
+      "#{CODES[code]}#{text}#{CODES[:reset]}"
+    end
+  end
+end

data/lib/tailgrab/history_reader.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Tailgrab
+  class HistoryReader
+    SUPPORTED_SHELLS = %i[zsh bash].freeze
+
+    attr_reader :shell, :history_file
+
+    def initialize(shell: nil, history_file: nil)
+      @shell = shell || detect_shell
+      @history_file = history_file || find_history_file
+    end
+
+    def last(count)
+      return [] unless history_file && File.exist?(history_file)
+
+      lines = read_last_lines(count)
+      lines.map { |line| parse_line(line) }.compact
+    end
+
+    private
+
+    def detect_shell
+      shell_env = ENV["SHELL"] || ""
+      if shell_env.include?("zsh")
+        :zsh
+      elsif shell_env.include?("bash")
+        :bash
+      else
+        :unknown
+      end
+    end
+
+    def find_history_file
+      histfile = ENV.fetch("HISTFILE", nil)
+      return File.expand_path(histfile) if histfile && !histfile.empty?
+
+      case shell
+      when :zsh
+        File.expand_path("~/.zsh_history")
+      when :bash
+        File.expand_path("~/.bash_history")
+      end
+    end
+
+    def read_last_lines(count)
+      lines = File.readlines(history_file, chomp: true).reject(&:empty?)
+      lines.last(count)
+    end
+
+    def parse_line(line)
+      case shell
+      when :zsh
+        parse_zsh_line(line)
+      else
+        line.strip
+      end
+    end
+
+    def parse_zsh_line(line)
+      # Zsh extended history format: ": <timestamp>:0;<command>"
+      match = line.match(/^: \d+:\d+;(.+)$/)
+      match ? match[1].strip : line.strip
+    end
+  end
+end

data/lib/tailgrab/storage.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require "time"
+
+module Tailgrab
+  class Storage
+    DEFAULT_FILE = File.join(Dir.home, "tailgrab.txt").freeze
+    TIMESTAMP_FORMAT = "%Y-%m-%d %H:%M:%S"
+    ENTRY_PATTERN = /^(\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}) \| (.+)$/
+
+    attr_reader :file_path
+
+    def initialize(file_path: DEFAULT_FILE)
+      @file_path = file_path
+    end
+
+    def save(commands)
+      timestamp = Time.now.strftime(TIMESTAMP_FORMAT)
+
+      File.open(file_path, "a") do |f|
+        commands.each do |cmd|
+          f.puts "#{timestamp} | #{cmd}"
+        end
+      end
+    end
+
+    def read_last(count)
+      return [] unless content?
+
+      entries = all_entries
+      entries.last(count)
+    end
+
+    def read_since(since_time)
+      return [] unless content?
+
+      all_entries.select do |entry|
+        ts = parse_timestamp(entry)
+        ts && ts >= since_time
+      end
+    end
+
+    def wipe
+      File.write(file_path, "")
+    end
+
+    def content?
+      File.exist?(file_path) && !File.empty?(file_path)
+    end
+
+    def extract_command(entry)
+      match = entry.match(ENTRY_PATTERN)
+      match ? match[2] : entry
+    end
+
+    def read_all
+      return [] unless content?
+
+      all_entries
+    end
+
+    private
+
+    def all_entries
+      File.readlines(file_path, chomp: true).reject(&:empty?)
+    end
+
+    def parse_timestamp(entry)
+      match = entry.match(ENTRY_PATTERN)
+      return nil unless match
+
+      Time.parse(match[1])
+    rescue ArgumentError
+      nil
+    end
+  end
+end

data/lib/tailgrab/version.rb

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

data/lib/tailgrab.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative "tailgrab/version"
+require_relative "tailgrab/history_reader"
+require_relative "tailgrab/clipboard"
+require_relative "tailgrab/colors"
+require_relative "tailgrab/storage"
+require_relative "tailgrab/cli"
+
+module Tailgrab
+end

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification
+name: tailgrab
+version: !ruby/object:Gem::Version
+  version: '1.0'
+platform: ruby
+authors:
+- Himanshu Panwar
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-02-28 00:00:00.000000000 Z
+dependencies: []
+description: Save and recall your terminal commands with timestamps
+email:
+- hpanwar@g2.com
+executables:
+- grab
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/grab
+- lib/tailgrab.rb
+- lib/tailgrab/cli.rb
+- lib/tailgrab/clipboard.rb
+- lib/tailgrab/colors.rb
+- lib/tailgrab/history_reader.rb
+- lib/tailgrab/storage.rb
+- lib/tailgrab/version.rb
+homepage: https://github.com/hpanwar09/tailgrab
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/hpanwar09/tailgrab
+  source_code_uri: https://github.com/hpanwar09/tailgrab
+  changelog_uri: https://github.com/hpanwar09/tailgrab/blob/master/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: Save and recall your terminal commands
+test_files: []