shai-cli 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1ea758284c9ecb5985d8789033ee4368ec95757ac056a0b5870f9d8f523d9282
-  data.tar.gz: 046a439279ef5a6c2cf32eeb9f5d00f7656887cb310168c334306796cd73f713
+  metadata.gz: '00490a68be250015b1cd43dd40cc804d79e82bb74ddc6fc65a4ef90d27b7de69'
+  data.tar.gz: d694b3f181f571b3ac8ebbbe415c92c805c4fb780cd8f3dae4cce0f6b32e6a6b
 SHA512:
-  metadata.gz: 3f158f9131a3d10a7717b4d2109e9ae37682b4c2d2f68de5ab516c0c4e789ad86556dff17b973c7a8daa23527486064057c1ef1b72c0064d206141a3f87bc204
-  data.tar.gz: e266d13cb6135d0530f5363e1f568a57fb2558a0a0b747b1b2820c4e921247d5114624727f4865711f44758d619f22bd233cd6464326612f2944aaba1b2514cc
+  metadata.gz: '08980b4e9a5623c01215cdbe58b1ad8d2ade01cd07ca4d84a3c61db346cbf0513efd663037740570fd17c8c2e61e14b7597d1444bd6701afad6a595ab2f95763'
+  data.tar.gz: 94016712713d1f3731b82b39a75e0d4d23b37f4149a2503bcfe8ae09aabf1ad59f03be7107f1dad0b1177e2168981fc07a5ab3ceaff123822adf1192220be7f0

data/README.md

@@ -56,8 +56,8 @@ shai login
 # Search for public configurations
 shai search "claude code"
 
-# Install a configuration to your project
-shai install anthropic/claude-expert
+# Install a configuration (--global for ~/, --local for ./)
+shai install anthropic/claude-expert --local
 
 # Create and share your own configuration
 shai init
@@ -76,12 +76,12 @@ These commands work without authentication for public configurations:
 | ------------------------- | ------------------------------------------------------ |
 | `shai search <query>`     | Search public configurations                           |
 | `shai install <config>`   | Install a public configuration (use `owner/slug` format) |
-| `shai uninstall <config>` | Uninstall a public configuration                       |
+| `shai uninstall <config>` | Uninstall a configuration                                |
 
 ```bash
 # No login needed for public configs
 shai search "claude code"
-shai install anthropic/claude-expert
+shai install anthropic/claude-expert --local
 shai uninstall anthropic/claude-expert
 ```
 
@@ -151,21 +151,69 @@ Token expires: March 11, 2026
 
 ### Using Configurations
 
-| Command                   | Description                              |
-| ------------------------- | ---------------------------------------- |
-| `shai install <config>`   | Install a configuration to local project |
-| `shai uninstall <config>` | Remove an installed configuration        |
+| Command                                | Description                              |
+| -------------------------------------- | ---------------------------------------- |
+| `shai install <config>`                | Install a configuration (prompts for location) |
+| `shai install <config> --global`       | Install to home directory (`~/`)         |
+| `shai install <config> --local`        | Install to current directory (`./`)      |
+| `shai install <config> --path <dir>`   | Install to a specific directory          |
+| `shai uninstall <config>`              | Remove an installed configuration        |
+| `shai uninstall <config> --global`     | Uninstall from home directory            |
+| `shai uninstall <config> --local`      | Uninstall from current directory         |
+
+**Global vs Local installs:**
+
+Configurations can be installed globally (to `~/`) or locally (to `./`). Global installs apply across all projects — useful for AI agent config files like `CLAUDE.md` or `.cursorrules`. Local installs are project-specific.
+
+```bash
+# Install globally (applies everywhere)
+$ shai install anthropic/claude-expert --global
+
+# Install locally (current project only)
+$ shai install anthropic/claude-expert --local
+
+# If you don't specify, shai will ask
+$ shai install anthropic/claude-expert
+? Where do you want to install?
+  ./ (local - current directory)
+  ~/ (global - home directory)
+```
+
+**Uninstalling:**
+
+shai tracks where each configuration was installed, so uninstall works without needing to remember the path:
 
 ```bash
 $ shai uninstall anthropic/claude-expert
-[✔] Fetching anthropic/claude-expert...
-Remove 3 files and 1 folder from 'anthropic/claude-expert'? (y/N) y
+Remove 3 files from 'anthropic/claude-expert'? (y/N) y
 
 ✓ Uninstalled anthropic/claude-expert
 ```
 
 ---
 
+### Skills
+
+| Command                                          | Description                              |
+| ------------------------------------------------ | ---------------------------------------- |
+| `shai skills`                                    | List all AI agent skills and their status |
+| `shai skills enable <name>`                      | Enable a disabled skill                  |
+| `shai skills enable <name> --global`             | Enable a global skill                    |
+| `shai skills disable <name>`                     | Disable an enabled skill                 |
+| `shai skills disable <name> --local`             | Disable a local skill                    |
+| `shai skills disable <name> --agent codex`       | Target a specific agent                  |
+
+Skills are `SKILL.md` files discovered across multiple AI agent directories:
+
+| Agent  | Global path                    | Local path                    |
+| ------ | ------------------------------ | ----------------------------- |
+| Claude | `~/.claude/skills/*/SKILL.md`  | `./.claude/skills/*/SKILL.md` |
+| Codex  | `~/.agents/skills/*/SKILL.md`  | `./.agents/skills/*/SKILL.md` |
+
+Disabling a skill renames `SKILL.md` to `SKILL.md.disabled` so the AI tool no longer loads it. Re-enabling reverses the rename. Use `--agent` to target a specific agent when the same skill name exists in multiple agents.
+
+---
+
 ### Authoring Configurations
 
 | Command                         | Description                        |
@@ -218,6 +266,12 @@ exclude:
 ## Examples
 
 ```bash
+# Install globally (to ~/)
+shai install anthropic/claude-expert --global
+
+# Install locally (to ./)
+shai install anthropic/claude-expert --local
+
 # Install to a specific directory
 shai install anthropic/claude-expert --path ./my-project
 
@@ -226,6 +280,9 @@ shai install anthropic/claude-expert --dry-run
 
 # Force overwrite existing files
 shai install anthropic/claude-expert --force
+
+# Uninstall (auto-detects where it was installed)
+shai uninstall anthropic/claude-expert
 ```
 
 ---

data/lib/shai/cli.rb

@@ -5,6 +5,7 @@ require_relative "commands/auth"
 require_relative "commands/configurations"
 require_relative "commands/sync"
 require_relative "commands/config"
+require_relative "commands/skills"
 require_relative "ui"
 
 module Shai
@@ -13,6 +14,7 @@ module Shai
     include Commands::Configurations
     include Commands::Sync
     include Commands::Config
+    include Commands::Skills
 
     def self.exit_on_failure?
       true
@@ -36,10 +38,15 @@ module Shai
       shell.say "  search <query>     Search public configurations"
       shell.say "  open <config>      Open a configuration in the browser"
       shell.say ""
-      shell.say "USING CONFIGURATIONS (install to current project):"
-      shell.say "  install <config>   Install a configuration to local project"
+      shell.say "USING CONFIGURATIONS:"
+      shell.say "  install <config>   Install a configuration (--global, --local, or --path)"
       shell.say "  uninstall <config> Remove an installed configuration"
       shell.say ""
+      shell.say "SKILLS:"
+      shell.say "  skills             List all AI agent skills and their status"
+      shell.say "  skills enable <n>  Enable a disabled skill (--global, --local, --agent)"
+      shell.say "  skills disable <n> Disable an enabled skill (--global, --local, --agent)"
+      shell.say ""
       shell.say "AUTHORING CONFIGURATIONS (create and publish):"
       shell.say "  init               Initialize a new configuration"
       shell.say "  push               Push local changes to remote"

data/lib/shai/commands/configurations.rb

@@ -71,16 +71,30 @@ module Shai
             end
           end
 
-          desc "install CONFIGURATION", "Install a configuration to local project"
+          desc "install CONFIGURATION", "Install a configuration"
           option :force, type: :boolean, aliases: "-f", default: false, desc: "Overwrite existing files"
           option :dry_run, type: :boolean, default: false, desc: "Show what would be installed"
-          option :path, type: :string, default: ".", desc: "Install to specific directory"
+          option :path, type: :string, desc: "Install to specific directory"
+          option :global, type: :boolean, default: false, desc: "Install to home directory (~)"
+          option :local, type: :boolean, default: false, desc: "Install to current directory (./)"
           def install(configuration)
             owner, slug = parse_configuration_name(configuration)
             display_name = owner ? "#{owner}/#{slug}" : slug
-            base_path = File.expand_path(options[:path])
+            base_path = resolve_install_path
             shairc_path = File.join(base_path, ".shairc")
 
+            registry = InstallRegistry.new
+
+            # Check if already installed elsewhere
+            if registry.has?(display_name) && !options[:force]
+              existing_path = registry.path_for(display_name)
+              if File.expand_path(existing_path) != base_path
+                ui.error("'#{display_name}' is already installed at #{existing_path}")
+                ui.info("Run `shai uninstall #{display_name}` first, or use --force to reinstall.")
+                exit EXIT_INVALID_INPUT
+              end
+            end
+
             installed = InstalledProjects.new(base_path)
 
             # Check if this exact project is already installed
@@ -214,6 +228,7 @@ module Shai
 
               # Track the installed project
               installed.add_project(display_name, created_files)
+              registry.add(display_name, base_path)
 
               # Record the install for analytics (fire and forget)
               begin
@@ -301,17 +316,21 @@ module Shai
             end
           end
 
-          desc "uninstall [CONFIGURATION]", "Remove an installed configuration from local project"
+          desc "uninstall [CONFIGURATION]", "Remove an installed configuration"
           option :dry_run, type: :boolean, default: false, desc: "Show what would be removed"
-          option :path, type: :string, default: ".", desc: "Path where configuration is installed"
+          option :global, type: :boolean, default: false, desc: "Uninstall from home directory (~)"
+          option :local, type: :boolean, default: false, desc: "Uninstall from current directory (./)"
           def uninstall(configuration = nil)
-            base_path = File.expand_path(options[:path])
+            registry = InstallRegistry.new
+
+            # Resolve base_path: explicit flag, registry lookup, or fallback to "."
+            base_path = resolve_uninstall_path(configuration, registry)
             installed = InstalledProjects.new(base_path)
 
             # If no configuration specified, determine which to uninstall
             if configuration.nil?
               if installed.empty?
-                ui.error("No configurations installed in this directory.")
+                ui.error("No configurations installed in #{base_path}")
                 ui.info("Usage: shai uninstall <configuration>")
                 exit EXIT_INVALID_INPUT
               elsif installed.project_count == 1
@@ -420,6 +439,7 @@ module Shai
 
             # Update tracking
             installed.remove_project(display_name)
+            registry.remove(display_name)
 
             # Remove tracking file if no more projects
             if installed.empty?
@@ -439,6 +459,56 @@ module Shai
 
       private
 
+      def resolve_uninstall_path(configuration, registry)
+        if options[:global] && options[:local]
+          ui.error("Conflicting options: use only one of --global or --local.")
+          exit EXIT_INVALID_INPUT
+        end
+
+        if options[:global]
+          return File.expand_path(Dir.home)
+        elsif options[:local]
+          return File.expand_path(".")
+        end
+
+        # Try registry lookup if a configuration name is given
+        if configuration
+          owner, slug = parse_configuration_name(configuration)
+          display_name = owner ? "#{owner}/#{slug}" : slug
+          registered_path = registry.path_for(display_name)
+          return File.expand_path(registered_path) if registered_path
+        end
+
+        # Default to current directory
+        File.expand_path(".")
+      end
+
+      def resolve_install_path
+        flag_count = 0
+        flag_count += 1 if options[:global]
+        flag_count += 1 if options[:local]
+        flag_count += 1 if options[:path]
+
+        if flag_count > 1
+          ui.error("Conflicting options: use only one of --global, --local, or --path.")
+          exit EXIT_INVALID_INPUT
+        end
+
+        if options[:path]
+          File.expand_path(options[:path])
+        elsif options[:global]
+          File.expand_path(Dir.home)
+        elsif options[:local]
+          File.expand_path(".")
+        else
+          choice = ui.select("Where do you want to install?", [
+            {name: "./ (local - current directory)", value: :local},
+            {name: "~/ (global - home directory)", value: :global}
+          ])
+          (choice == :global) ? File.expand_path(Dir.home) : File.expand_path(".")
+        end
+      end
+
       def parse_configuration_name(name)
         if name.include?("/")
           name.split("/", 2)

data/lib/shai/commands/skills.rb

@@ -0,0 +1,199 @@
+# frozen_string_literal: true
+
+module Shai
+  module Commands
+    module Skills
+      def self.included(base)
+        base.class_eval do
+          desc "skills [SUBCOMMAND]", "Manage AI agent skills"
+          method_option :global, type: :boolean, default: false, desc: "Target global skills"
+          method_option :local, type: :boolean, default: false, desc: "Target local skills"
+          method_option :agent, type: :string, desc: "Target a specific agent (e.g. claude, codex)"
+          def skills(subcommand = nil, *args)
+            case subcommand
+            when nil, "list"
+              skills_list
+            when "enable"
+              name = args.first
+              unless name
+                ui.error("Usage: shai skills enable <name> [--global|--local] [--agent <agent>]")
+                exit EXIT_INVALID_INPUT
+              end
+              skills_enable(name)
+            when "disable"
+              name = args.first
+              unless name
+                ui.error("Usage: shai skills disable <name> [--global|--local] [--agent <agent>]")
+                exit EXIT_INVALID_INPUT
+              end
+              skills_disable(name)
+            else
+              ui.error("Unknown subcommand: #{subcommand}. Use `shai skills`, `shai skills enable`, or `shai skills disable`")
+              exit EXIT_INVALID_INPUT
+            end
+          end
+        end
+      end
+
+      private
+
+      def skills_list
+        scanner = SkillScanner.new
+        all_skills = scanner.scan_all
+        populate_sources!(all_skills)
+
+        if all_skills.empty?
+          ui.info("No skills found.")
+          ui.blank
+          ui.info("Skill discovery paths:")
+          SkillScanner::AGENTS.each do |agent|
+            ui.info("  Global: ~/#{agent[:skill_dir]}/*/SKILL.md (#{agent[:name]})")
+            ui.info("  Local:  ./#{agent[:skill_dir]}/*/SKILL.md (#{agent[:name]})")
+          end
+          return
+        end
+
+        global_skills = all_skills.select { |s| s.scope == :global }
+        local_skills = all_skills.select { |s| s.scope == :local }
+
+        if global_skills.any?
+          ui.blank
+          ui.header("Global skills")
+          ui.blank
+          ui.table(
+            ["Skill", "Status", "Agent", "Source"],
+            global_skills.map { |s| skill_row(s) }
+          )
+        end
+
+        if local_skills.any?
+          ui.blank
+          ui.header("Local skills")
+          ui.blank
+          ui.table(
+            ["Skill", "Status", "Agent", "Source"],
+            local_skills.map { |s| skill_row(s) }
+          )
+        end
+
+        enabled_count = all_skills.count(&:enabled)
+        disabled_count = all_skills.count { |s| !s.enabled }
+        ui.blank
+        ui.info("#{enabled_count} enabled, #{disabled_count} disabled")
+      end
+
+      def skills_enable(name)
+        scanner, skill = resolve_skill(scanner_instance, name)
+        return unless skill
+
+        if skill.enabled
+          ui.info("Skill '#{name}' is already enabled (#{skill.scope}, #{skill.agent})")
+          return
+        end
+
+        scanner.enable!(skill)
+        ui.success("Enabled skill '#{name}' (#{skill.scope}, #{skill.agent})")
+      end
+
+      def skills_disable(name)
+        scanner, skill = resolve_skill(scanner_instance, name)
+        return unless skill
+
+        unless skill.enabled
+          ui.info("Skill '#{name}' is already disabled (#{skill.scope}, #{skill.agent})")
+          return
+        end
+
+        scanner.disable!(skill)
+        ui.success("Disabled skill '#{name}' (#{skill.scope}, #{skill.agent})")
+      end
+
+      def scanner_instance
+        SkillScanner.new
+      end
+
+      def resolve_skill(scanner, name)
+        validate_scope_flags!
+        validate_agent_flag!
+
+        scope = if options[:global]
+          :global
+        elsif options[:local]
+          :local
+        end
+
+        agent = options[:agent]
+
+        matches = scanner.find(name, scope: scope, agent: agent)
+
+        if matches.empty?
+          ui.error("Skill '#{name}' not found. Run `shai skills` to see available skills.")
+          exit EXIT_NOT_FOUND
+        end
+
+        if matches.length > 1
+          ambiguous_by_scope = matches.map(&:scope).uniq.length > 1
+          ambiguous_by_agent = matches.map(&:agent).uniq.length > 1
+
+          ui.error("Skill '#{name}' exists in multiple #{ambiguous_by_agent ? "agents" : "scopes"}:")
+          matches.each { |s| ui.info("  - #{s.scope}, #{s.agent} (#{s.path})") }
+
+          hints = []
+          hints << "--global or --local" if ambiguous_by_scope
+          hints << "--agent <agent>" if ambiguous_by_agent
+          ui.info("Use #{hints.join(" and ")} to specify which one.")
+          exit EXIT_INVALID_INPUT
+        end
+
+        [scanner, matches.first]
+      end
+
+      def validate_scope_flags!
+        if options[:global] && options[:local]
+          ui.error("Cannot use --global and --local together")
+          exit EXIT_INVALID_INPUT
+        end
+      end
+
+      def validate_agent_flag!
+        agent = options[:agent]
+        return unless agent
+
+        known = SkillScanner::AGENTS.map { |a| a[:name] }
+        unless known.include?(agent)
+          ui.error("Unknown agent '#{agent}'. Known agents: #{known.join(", ")}")
+          exit EXIT_INVALID_INPUT
+        end
+      end
+
+      def skill_row(skill)
+        status = skill.enabled ? "enabled" : "disabled"
+        source = skill.source || "-"
+        [skill.name, status, skill.agent, source]
+      end
+
+      def populate_sources!(skills)
+        [Dir.home, Dir.pwd].each do |base|
+          installed = InstalledProjects.new(base)
+          next if installed.empty?
+
+          skills.each do |skill|
+            next if skill.source
+
+            installed.project_slugs.each do |slug|
+              files = installed.files_for_project(slug)
+              SkillScanner::AGENTS.each do |agent|
+                skill_relative = "#{agent[:skill_dir]}/#{skill.name}/SKILL.md"
+                if files.any? { |f| f == skill_relative || f.start_with?("#{agent[:skill_dir]}/#{skill.name}/") }
+                  skill.source = slug
+                  break
+                end
+              end
+              break if skill.source
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/shai/install_registry.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require "yaml"
+require "time"
+require "fileutils"
+
+module Shai
+  class InstallRegistry
+    def initialize
+      @file_path = File.join(Shai.configuration.config_dir, "installations.yml")
+      @data = load_data
+    end
+
+    attr_reader :file_path
+
+    def add(slug, path)
+      @data["projects"][slug] = {
+        "path" => File.expand_path(path),
+        "installed_at" => Time.now.iso8601
+      }
+      save!
+    end
+
+    def remove(slug)
+      removed = @data["projects"].delete(slug)
+      save! if removed
+      removed
+    end
+
+    def path_for(slug)
+      @data.dig("projects", slug, "path")
+    end
+
+    def all
+      @data["projects"].dup
+    end
+
+    def has?(slug)
+      @data["projects"].key?(slug)
+    end
+
+    private
+
+    def load_data
+      return default_data unless File.exist?(@file_path)
+
+      raw = YAML.safe_load_file(@file_path) || {}
+      (raw.is_a?(Hash) && raw["projects"].is_a?(Hash)) ? raw : default_data
+    rescue
+      default_data
+    end
+
+    def default_data
+      {"projects" => {}}
+    end
+
+    def save!
+      FileUtils.mkdir_p(File.dirname(@file_path))
+      File.write(@file_path, YAML.dump(@data))
+    end
+  end
+end

data/lib/shai/skill_scanner.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+module Shai
+  Skill = Struct.new(:name, :scope, :enabled, :path, :source, :agent, keyword_init: true)
+
+  class SkillScanner
+    SKILL_FILE = "SKILL.md"
+    DISABLED_SUFFIX = ".disabled"
+
+    AGENTS = [
+      {name: "claude", skill_dir: ".claude/skills"},
+      {name: "codex", skill_dir: ".agents/skills"}
+    ].freeze
+
+    attr_reader :local_base, :global_base
+
+    def initialize(local_base: Dir.pwd, global_base: Dir.home)
+      @local_base = File.expand_path(local_base)
+      @global_base = File.expand_path(global_base)
+    end
+
+    def scan_all
+      skills = []
+      skills.concat(scan_scope(:global))
+      skills.concat(scan_scope(:local))
+      skills
+    end
+
+    def find(name, scope: nil, agent: nil)
+      skills = scan_all
+      skills.select! { |s| s.name == name }
+      skills.select! { |s| s.scope == scope } if scope
+      skills.select! { |s| s.agent == agent } if agent
+      skills
+    end
+
+    def enable!(skill)
+      return false if skill.enabled
+      disabled_path = skill.path
+      enabled_path = disabled_path.sub(/#{Regexp.escape(DISABLED_SUFFIX)}$/o, "")
+      return false unless File.exist?(disabled_path)
+
+      File.rename(disabled_path, enabled_path)
+      true
+    end
+
+    def disable!(skill)
+      return false unless skill.enabled
+      enabled_path = skill.path
+      disabled_path = "#{enabled_path}#{DISABLED_SUFFIX}"
+      return false unless File.exist?(enabled_path)
+
+      File.rename(enabled_path, disabled_path)
+      true
+    end
+
+    private
+
+    def scan_scope(scope)
+      base = (scope == :global) ? global_base : local_base
+      skills = []
+
+      AGENTS.each do |agent|
+        skill_dir = File.join(base, agent[:skill_dir])
+        next unless Dir.exist?(skill_dir)
+
+        Dir.children(skill_dir).sort.each do |entry|
+          full_dir = File.join(skill_dir, entry)
+          next unless File.directory?(full_dir)
+
+          enabled_file = File.join(full_dir, SKILL_FILE)
+          disabled_file = File.join(full_dir, "#{SKILL_FILE}#{DISABLED_SUFFIX}")
+
+          if File.exist?(enabled_file)
+            skills << Skill.new(
+              name: entry,
+              scope: scope,
+              enabled: true,
+              path: enabled_file,
+              source: nil,
+              agent: agent[:name]
+            )
+          elsif File.exist?(disabled_file)
+            skills << Skill.new(
+              name: entry,
+              scope: scope,
+              enabled: false,
+              path: disabled_file,
+              source: nil,
+              agent: agent[:name]
+            )
+          end
+        end
+      end
+
+      skills
+    end
+  end
+end

data/lib/shai/version.rb

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

data/lib/shai.rb

@@ -5,6 +5,8 @@ require_relative "shai/configuration"
 require_relative "shai/credentials"
 require_relative "shai/api_client"
 require_relative "shai/installed_projects"
+require_relative "shai/install_registry"
+require_relative "shai/skill_scanner"
 require_relative "shai/cli"
 
 module Shai

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: shai-cli
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Sebastian Jimenez
@@ -139,10 +139,13 @@ files:
 - lib/shai/commands/auth.rb
 - lib/shai/commands/config.rb
 - lib/shai/commands/configurations.rb
+- lib/shai/commands/skills.rb
 - lib/shai/commands/sync.rb
 - lib/shai/configuration.rb
 - lib/shai/credentials.rb
+- lib/shai/install_registry.rb
 - lib/shai/installed_projects.rb
+- lib/shai/skill_scanner.rb
 - lib/shai/ui.rb
 - lib/shai/version.rb
 homepage: https://shaicli.dev
@@ -167,7 +170,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.3
 specification_version: 4
 summary: CLI tool for managing shared AI agent configurations
 test_files: []