shai-cli 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f13b2f27c4542d4f5fe83f06e781589bd69bde8bd618e7b8ce494fd1d4ab621b
+  data.tar.gz: 94129b59f660fcff737602a475b891d87526968bd3ee4b28d495012a225d6cd5
+SHA512:
+  metadata.gz: 4d89e81bdb2d09f584d53fb9c652e61d38ec7e40378e2ccca88b12b75bed765dd0aa18692fd0599a17095ec331f0e5aabfdcabea1da5c89df9ad927cacb396dc
+  data.tar.gz: e636e3d6f766962c11df07de32e70fd62944e2e09c4a0e2acbb723291b75e5425e2b922a98e55e110bb12c3fd277d27993c9e9eda912713065f6897086ed5248

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 InfinitLab
+
+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,192 @@
+# shai-cli
+
+Command-line tool for managing and sharing AI agent configurations via [shaicli.dev](https://shaicli.dev).
+
+## Installation
+
+### Quick install (recommended)
+
+```bash
+curl -fsSL https://shaicli.dev/install.sh | bash
+```
+
+### Via RubyGems
+
+```bash
+gem install shai-cli
+```
+
+### From source
+
+```bash
+git clone https://github.com/infinitlab/shai-cli.git
+cd shai-cli
+bundle install
+bundle exec rake install
+```
+
+## Quick Start
+
+```bash
+# Login to your shaicli.dev account
+shai login
+
+# Search for public configurations
+shai search "claude code"
+
+# Install a configuration to your project
+shai install anthropic/claude-expert
+
+# Create and share your own configuration
+shai init
+shai push
+```
+
+## Commands
+
+### Authentication
+
+| Command | Description |
+|---------|-------------|
+| `shai login` | Log in to shaicli.dev |
+| `shai logout` | Log out and remove stored credentials |
+| `shai whoami` | Show current authentication status |
+
+### Discovery
+
+| Command | Description |
+|---------|-------------|
+| `shai list` | List your configurations |
+| `shai search <query>` | Search public configurations |
+
+### Using Configurations
+
+| Command | Description |
+|---------|-------------|
+| `shai install <config>` | Install a configuration to local project |
+| `shai uninstall <config>` | Remove an installed configuration |
+
+### Authoring Configurations
+
+| Command | Description |
+|---------|-------------|
+| `shai init` | Initialize a new configuration |
+| `shai push` | Push local changes to remote |
+| `shai status` | Show local changes vs remote |
+| `shai diff` | Show diff between local and remote |
+| `shai config show` | Show configuration details |
+| `shai config set <key> <value>` | Update configuration metadata |
+| `shai delete <slug>` | Delete a configuration from remote |
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `SHAI_API_URL` | API endpoint URL | `https://shaicli.dev` |
+| `SHAI_CONFIG_DIR` | Directory for credentials | `~/.config/shai` |
+| `SHAI_TOKEN` | Override authentication token | - |
+| `NO_COLOR` | Disable colored output | - |
+
+### .shairc File
+
+When authoring configurations, a `.shairc` file is created in your project root:
+
+```yaml
+# .shairc - Shai configuration
+slug: my-config
+include:
+  - .claude/**
+  - .cursor/**
+exclude:
+  - "**/*.local.*"
+  - "**/.env"
+```
+
+| Field | Description |
+|-------|-------------|
+| `slug` | Unique identifier for your configuration |
+| `include` | Glob patterns for files to include |
+| `exclude` | Glob patterns for files to exclude |
+
+## Examples
+
+### Search by tags
+
+```bash
+shai search --tag claude --tag coding
+```
+
+### Install to specific directory
+
+```bash
+shai install anthropic/claude-expert --path ./my-project
+```
+
+### Preview installation without making changes
+
+```bash
+shai install anthropic/claude-expert --dry-run
+```
+
+### Force overwrite existing files
+
+```bash
+shai install anthropic/claude-expert --force
+```
+
+### Create a public configuration
+
+```bash
+shai init
+# Follow prompts, select "public" visibility
+shai push
+```
+
+### Update configuration metadata
+
+```bash
+shai config set name "My Updated Config"
+shai config set visibility public
+shai config set description "A better description"
+```
+
+## Development
+
+### Setup
+
+```bash
+bundle install
+```
+
+### Run tests
+
+```bash
+bundle exec rspec
+```
+
+### Run linter
+
+```bash
+bundle exec standardrb
+```
+
+### Local development
+
+Create `.env.development`:
+
+```bash
+SHAI_API_URL=http://localhost:3001
+SHAI_CONFIG_DIR=.config/shai-dev
+```
+
+Run commands in development mode:
+
+```bash
+SHAI_ENV=development bundle exec bin/shai <command>
+```
+
+## License
+
+MIT

data/bin/shai

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Load environment variables from .env files (development only)
+begin
+  require "dotenv"
+
+  env = ENV.fetch("SHAI_ENV", "development")
+  env_files = [
+    ".env.#{env}.local",
+    ".env.#{env}",
+    ".env.local",
+    ".env"
+  ].select { |f| File.exist?(f) }
+
+  Dotenv.load(*env_files) if env_files.any?
+rescue LoadError
+  # dotenv not available (production gem install), skip
+end
+
+require_relative "../lib/shai"
+
+Shai::CLI.start(ARGV)

data/lib/shai/api_client.rb

@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+require "faraday"
+require "json"
+require "uri"
+
+module Shai
+  class ApiClient
+    def initialize
+      @connection = build_connection
+    end
+
+    # Authentication
+    def login(identifier:, password:, client_name: nil)
+      client_name ||= default_client_name
+      post("/api/v1/cli/session", {
+        identifier: identifier,
+        password: password,
+        client_name: client_name
+      })
+    end
+
+    # Configurations
+    def list_configurations
+      get("/api/v1/configurations")
+    end
+
+    def search_configurations(query: nil, tags: [])
+      params = {}
+      params[:q] = query if query
+      params["tags[]"] = tags if tags.any?
+      get("/api/v1/configurations/search", params)
+    end
+
+    def get_configuration(identifier)
+      get("/api/v1/configurations/#{encode_identifier(identifier)}")
+    end
+
+    def create_configuration(name:, description: nil, visibility: "private")
+      post("/api/v1/configurations", {
+        configuration: {
+          name: name,
+          description: description,
+          visibility: visibility
+        }
+      })
+    end
+
+    def update_configuration(identifier, **attributes)
+      put("/api/v1/configurations/#{encode_identifier(identifier)}", {
+        configuration: attributes
+      })
+    end
+
+    def delete_configuration(identifier)
+      delete("/api/v1/configurations/#{encode_identifier(identifier)}")
+    end
+
+    def get_tree(identifier)
+      get("/api/v1/configurations/#{encode_identifier(identifier)}/tree")
+    end
+
+    def update_tree(identifier, tree)
+      put("/api/v1/configurations/#{encode_identifier(identifier)}/tree", {tree: tree})
+    end
+
+    # Encode identifier for URL (handles owner/slug format)
+    def encode_identifier(identifier)
+      URI.encode_www_form_component(identifier)
+    end
+
+    private
+
+    def build_connection
+      Faraday.new(url: Shai.configuration.api_url) do |conn|
+        conn.request :json
+        conn.response :json, content_type: /\bjson$/
+        conn.adapter Faraday.default_adapter
+      end
+    end
+
+    def get(path, params = {})
+      response = @connection.get(path, params) do |req|
+        add_auth_header(req)
+      end
+      handle_response(response)
+    end
+
+    def post(path, body)
+      response = @connection.post(path) do |req|
+        add_auth_header(req)
+        req.body = body
+      end
+      handle_response(response)
+    end
+
+    def put(path, body)
+      response = @connection.put(path) do |req|
+        add_auth_header(req)
+        req.body = body
+      end
+      handle_response(response)
+    end
+
+    def delete(path)
+      response = @connection.delete(path) do |req|
+        add_auth_header(req)
+      end
+      handle_response(response)
+    end
+
+    def add_auth_header(request)
+      token = Shai.configuration.token || Shai.credentials.token
+      request.headers["Authorization"] = "Bearer #{token}" if token
+    end
+
+    def handle_response(response)
+      case response.status
+      when 200..299
+        response.body
+      when 401
+        raise AuthenticationError, response.body&.dig("error") || "Authentication failed"
+      when 403
+        raise PermissionDeniedError, response.body&.dig("error") || "Permission denied"
+      when 404
+        raise NotFoundError, response.body&.dig("error") || "Not found"
+      when 422
+        raise InvalidConfigurationError, response.body&.dig("error") || "Invalid request"
+      else
+        raise Error, response.body&.dig("error") || "Request failed with status #{response.status}"
+      end
+    rescue Faraday::ConnectionFailed, Faraday::TimeoutError
+      raise NetworkError, "Could not connect to #{Shai.configuration.api_url}. Check your internet connection."
+    end
+
+    def default_client_name
+      hostname = begin
+        require "socket"
+        Socket.gethostname
+      rescue
+        "Unknown"
+      end
+      "CLI (#{hostname})"
+    end
+  end
+end

data/lib/shai/cli.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+require "thor"
+require_relative "commands/auth"
+require_relative "commands/configurations"
+require_relative "commands/sync"
+require_relative "commands/config"
+require_relative "ui"
+
+module Shai
+  class CLI < Thor
+    include Commands::Auth
+    include Commands::Configurations
+    include Commands::Sync
+    include Commands::Config
+
+    def self.exit_on_failure?
+      true
+    end
+
+    # Custom help to group commands by category
+    def self.help(shell, subcommand = false)
+      shell.say "shai - Manage AI agent configurations"
+      shell.say ""
+      shell.say "USAGE:"
+      shell.say "  shai <command> [options]"
+      shell.say ""
+      shell.say "AUTHENTICATION:"
+      shell.say "  login              Log in to shaicli.dev"
+      shell.say "  logout             Log out and remove stored credentials"
+      shell.say "  whoami             Show current authentication status"
+      shell.say ""
+      shell.say "DISCOVERY:"
+      shell.say "  list               List your configurations"
+      shell.say "  search <query>     Search public configurations"
+      shell.say ""
+      shell.say "USING CONFIGURATIONS (install to current project):"
+      shell.say "  install <config>   Install a configuration to local project"
+      shell.say "  uninstall <config> Remove an installed configuration"
+      shell.say ""
+      shell.say "AUTHORING CONFIGURATIONS (create and publish):"
+      shell.say "  init               Initialize a new configuration"
+      shell.say "  push               Push local changes to remote"
+      shell.say "  status             Show local changes vs remote"
+      shell.say "  diff               Show diff between local and remote"
+      shell.say "  config show        Show configuration details"
+      shell.say "  config set <k> <v> Update configuration metadata"
+      shell.say "  delete <slug>      Delete a configuration from remote"
+      shell.say ""
+      shell.say "OPTIONS:"
+      shell.say "  -h, --help         Show help for a command"
+      shell.say "  -v, --version      Show version"
+      shell.say "  --verbose          Enable verbose output"
+      shell.say "  --no-color         Disable colored output"
+      shell.say ""
+      shell.say "EXAMPLES:"
+      shell.say "  shai login"
+      shell.say "  shai search \"claude code\""
+      shell.say "  shai install anthropic/claude-expert"
+      shell.say "  shai init"
+      shell.say "  shai push"
+      shell.say ""
+      shell.say "Run 'shai help <command>' for more information on a command."
+    end
+
+    class_option :verbose, type: :boolean, default: false, desc: "Enable verbose output"
+    class_option :no_color, type: :boolean, default: false, desc: "Disable colored output"
+
+    desc "version", "Show version"
+    map %w[-v --version] => :version
+    def version
+      puts "shai #{Shai::VERSION}"
+    end
+
+    private
+
+    def ui
+      @ui ||= UI.new(color: !options[:no_color])
+    end
+
+    def api
+      Shai.api_client
+    end
+
+    def credentials
+      Shai.credentials
+    end
+
+    def require_auth!
+      return if credentials.authenticated?
+
+      ui.error("Not logged in. Run `shai login` to authenticate.")
+      exit EXIT_AUTH_REQUIRED
+    end
+  end
+end

data/lib/shai/commands/auth.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module Shai
+  module Commands
+    module Auth
+      def self.included(base)
+        base.class_eval do
+          desc "login", "Log in to shaicli.dev"
+          def login
+            identifier = ui.ask("Email or username:")
+            password = ui.mask("Password:")
+
+            ui.blank
+
+            begin
+              response = ui.spinner("Logging in...") do
+                api.login(identifier: identifier, password: password)
+              end
+
+              data = response["data"]
+              credentials.save(
+                token: data["token"],
+                expires_at: data["expires_at"],
+                user: data["user"]
+              )
+
+              ui.success("Logged in as #{data.dig("user", "username")}")
+              ui.indent("Token expires: #{format_date(data["expires_at"])}")
+              ui.indent("Token stored in #{Shai.configuration.credentials_path}")
+            rescue AuthenticationError
+              ui.error("Invalid credentials")
+              exit EXIT_AUTH_REQUIRED
+            rescue NetworkError => e
+              ui.error(e.message)
+              exit EXIT_NETWORK_ERROR
+            end
+          end
+
+          desc "logout", "Log out and remove stored credentials"
+          def logout
+            credentials.clear
+            ui.success("Logged out successfully")
+          end
+
+          desc "whoami", "Show current authentication status"
+          def whoami
+            if credentials.authenticated?
+              name = credentials.display_name || credentials.username
+              ui.info("Logged in as #{credentials.username} (#{name})")
+              ui.info("Token expires: #{format_date(credentials.expires_at)}")
+            else
+              ui.info("Not logged in. Run `shai login` to authenticate.")
+            end
+          end
+        end
+      end
+
+      private
+
+      def format_date(date_string)
+        return "unknown" unless date_string
+
+        date = Time.parse(date_string)
+        date.strftime("%B %-d, %Y")
+      rescue ArgumentError
+        date_string
+      end
+    end
+  end
+end