legionio 1.4.118 → 1.4.119

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a10f06b3cc591d8fa5aae3b31216e037826f961962df05276ba5fbd78805235c
-  data.tar.gz: 5a9e88f6bbb42b27586adba45becd7ecaedc69f190bd3f0fbddb3de27fcffd79
+  metadata.gz: ac22c22ec64e117b1568d5569a2983e46fdc9aadb566642c05c35973fb29428a
+  data.tar.gz: e6b5a99eebc5b0de37a59ad9cebc4fd5e96b8fb125b1974faa64e2454e268907
 SHA512:
-  metadata.gz: 3cab7e4e400553baf1b57918d610dbb7a0dd1143dd4df52f104bd03e55d23e53bfbffd815c32b9836ec421ba58c613b32ec97d6af0b68f26cf0fdb55570e7790
-  data.tar.gz: 13c8e47feeccf21c4ea33b2ddd31f37f8afd6f73765e6df48ead40e6e2a96125019c9b5aa1107383db46958bcaf51a7cd593344f70b1d295e807dedf33b1d41f
+  metadata.gz: 789c1485afd78d006d6d9aad725e483c5b6fd467a952476a11e1db29ac8c710f9d80c7e8dce4ac0045627abc45defae5ae45ebe995d167b95ffa866897ae4979
+  data.tar.gz: 852f58359d4cb4beb1a1708f6d01f9423dc2d18e0d9f028493f2f018eaa5f999b87c564b8015d39004f08ff70e43e41ff92bfcb075fc28b8608281c702704fd8

data/.rubocop.yml

@@ -48,6 +48,7 @@ Metrics/BlockLength:
     - 'lib/legion/api/acp.rb'
     - 'lib/legion/api/auth_saml.rb'
     - 'lib/legion/cli/failover_command.rb'
+    - 'lib/legion/cli/setup_command.rb'
 
 Metrics/AbcSize:
   Max: 60

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Legion Changelog
 
+## [1.4.119] - 2026-03-22
+
+### Added
+- `legion setup claude-code` installs Legion MCP server entry into `~/.claude/settings.json` and writes the `/legion` slash command skill to `~/.claude/commands/legion.md`
+- `legion setup cursor` installs Legion MCP server entry into `.cursor/mcp.json` in the current project directory
+- `legion setup vscode` installs Legion MCP server entry into `.vscode/mcp.json` using the VS Code stdio server format
+- `legion setup status` shows which platforms (Claude Code, Cursor, VS Code) have Legion MCP configured
+- All `legion setup` subcommands support `--force` to overwrite existing entries and `--json` for machine-readable output
+- MCP installs merge with existing server configs rather than overwriting unrelated entries
+
 ## [1.4.118] - 2026-03-22
 
 ### Added

data/lib/legion/cli/setup_command.rb

@@ -0,0 +1,252 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'fileutils'
+require 'thor'
+require 'legion/cli/output'
+
+module Legion
+  module CLI
+    class Setup < Thor
+      namespace 'setup'
+
+      def self.exit_on_failure?
+        true
+      end
+
+      class_option :json,     type: :boolean, default: false, desc: 'Output as JSON'
+      class_option :no_color, type: :boolean, default: false, desc: 'Disable color output'
+      class_option :force,    type: :boolean, default: false, desc: 'Overwrite existing config'
+
+      LEGION_MCP_ENTRY = {
+        'command' => 'legionio',
+        'args'    => %w[mcp stdio]
+      }.freeze
+
+      SKILL_CONTENT = <<~MARKDOWN
+        ---
+        name: legion
+        description: Orchestrate LegionIO extensions and agents
+        ---
+
+        You have access to LegionIO MCP tools. When the user asks you to work with Legion:
+
+        1. Use `legion.discover_tools` to find relevant capabilities
+        2. Use `legion.do_action` for natural language task routing
+        3. Use `legion.run_task` to execute specific extension functions
+        4. Use `legion.list_peers` and `legion.ask_peer` for agent coordination
+        5. Present results as a consolidated summary
+      MARKDOWN
+
+      desc 'claude-code', 'Install Legion MCP server and slash command skill for Claude Code'
+      def claude_code
+        out = formatter
+        installed = []
+
+        install_claude_mcp(installed)
+        install_claude_skill(installed)
+
+        if options[:json]
+          out.json(platform: 'claude-code', installed: installed)
+        else
+          out.spacer
+          out.success("Legion configured for Claude Code (#{installed.size} item(s))")
+          out.spacer
+          puts "  Run '/legion' in Claude Code to use your LegionIO tools."
+        end
+      end
+
+      desc 'cursor', 'Install Legion MCP server config for Cursor'
+      def cursor
+        out = formatter
+        path = File.join(Dir.pwd, '.cursor', 'mcp.json')
+        installed = []
+
+        write_mcp_servers_json(nil, path, installed)
+
+        if options[:json]
+          out.json(platform: 'cursor', installed: installed)
+        else
+          out.spacer
+          out.success("Legion configured for Cursor (#{installed.size} item(s))")
+          out.spacer
+          puts "  MCP config written to: #{path}"
+        end
+      end
+
+      desc 'vscode', 'Install Legion MCP server config for VS Code'
+      def vscode
+        out = formatter
+        path = File.join(Dir.pwd, '.vscode', 'mcp.json')
+        installed = []
+
+        write_vscode_mcp_json(nil, path, installed)
+
+        if options[:json]
+          out.json(platform: 'vscode', installed: installed)
+        else
+          out.spacer
+          out.success("Legion configured for VS Code (#{installed.size} item(s))")
+          out.spacer
+          puts "  MCP config written to: #{path}"
+        end
+      end
+
+      desc 'status', 'Show which platforms have Legion MCP configured'
+      def status
+        out = formatter
+        platforms = check_all_platforms
+
+        if options[:json]
+          out.json(platforms: platforms)
+        else
+          out.header('Legion MCP Setup Status')
+          out.spacer
+          platforms.each do |p|
+            icon = p[:configured] ? out.colorize('configured', :success) : out.colorize('not configured', :muted)
+            puts "  #{out.colorize(p[:name].ljust(16), :label)} #{icon}"
+            puts "    #{out.colorize(p[:path], :muted)}" if p[:path]
+          end
+          out.spacer
+          configured_count = platforms.count { |p| p[:configured] }
+          puts "  #{configured_count} of #{platforms.size} platform(s) configured"
+        end
+      end
+
+      no_commands do
+        def formatter
+          @formatter ||= Output::Formatter.new(
+            json:  options[:json],
+            color: !options[:no_color]
+          )
+        end
+
+        private
+
+        def install_claude_mcp(installed)
+          settings_path = File.expand_path('~/.claude/settings.json')
+          existing = load_json_file(settings_path)
+          servers  = existing['mcpServers'] || {}
+
+          if servers.key?('legion') && !options[:force]
+            puts '  Claude Code MCP entry already present (use --force to overwrite)' unless options[:json]
+            return
+          end
+
+          servers['legion'] = LEGION_MCP_ENTRY
+          existing['mcpServers'] = servers
+
+          write_json_file(settings_path, existing)
+          installed << settings_path
+          puts "  Wrote MCP server entry to #{settings_path}" unless options[:json]
+        end
+
+        def install_claude_skill(installed)
+          skill_path = File.expand_path('~/.claude/commands/legion.md')
+
+          if File.exist?(skill_path) && !options[:force]
+            puts '  Claude Code skill already present (use --force to overwrite)' unless options[:json]
+            return
+          end
+
+          FileUtils.mkdir_p(File.dirname(skill_path))
+          File.write(skill_path, SKILL_CONTENT)
+          installed << skill_path
+          puts "  Wrote slash command skill to #{skill_path}" unless options[:json]
+        end
+
+        def write_mcp_servers_json(_out, path, installed)
+          existing = load_json_file(path)
+          servers  = existing['mcpServers'] || {}
+
+          if servers.key?('legion') && !options[:force]
+            puts "  Legion entry already present in #{path} (use --force to overwrite)" unless options[:json]
+            return
+          end
+
+          servers['legion'] = LEGION_MCP_ENTRY
+          existing['mcpServers'] = servers
+
+          write_json_file(path, existing)
+          installed << path
+          puts "  Wrote MCP config to #{path}" unless options[:json]
+        end
+
+        def write_vscode_mcp_json(_out, path, installed)
+          existing = load_json_file(path)
+          servers  = existing['servers'] || {}
+
+          if servers.key?('legion') && !options[:force]
+            puts "  Legion entry already present in #{path} (use --force to overwrite)" unless options[:json]
+            return
+          end
+
+          servers['legion'] = {
+            'type'    => 'stdio',
+            'command' => 'legionio',
+            'args'    => %w[mcp stdio]
+          }
+          existing['servers'] = servers
+
+          write_json_file(path, existing)
+          installed << path
+          puts "  Wrote MCP config to #{path}" unless options[:json]
+        end
+
+        def load_json_file(path)
+          return {} unless File.exist?(path)
+
+          ::JSON.parse(File.read(path))
+        rescue ::JSON::ParserError
+          {}
+        end
+
+        def write_json_file(path, data)
+          FileUtils.mkdir_p(File.dirname(path))
+          File.write(path, ::JSON.pretty_generate(data))
+        end
+
+        def check_all_platforms
+          [
+            check_claude_code,
+            check_cursor,
+            check_vscode
+          ]
+        end
+
+        def check_claude_code
+          path = File.expand_path('~/.claude/settings.json')
+          configured = begin
+            data = ::JSON.parse(File.read(path))
+            data.dig('mcpServers', 'legion') ? true : false
+          rescue StandardError
+            false
+          end
+          { name: 'Claude Code', path: path, configured: configured }
+        end
+
+        def check_cursor
+          path = File.join(Dir.pwd, '.cursor', 'mcp.json')
+          configured = begin
+            data = ::JSON.parse(File.read(path))
+            data.dig('mcpServers', 'legion') ? true : false
+          rescue StandardError
+            false
+          end
+          { name: 'Cursor', path: path, configured: configured }
+        end
+
+        def check_vscode
+          path = File.join(Dir.pwd, '.vscode', 'mcp.json')
+          configured = begin
+            data = ::JSON.parse(File.read(path))
+            data.dig('servers', 'legion') ? true : false
+          rescue StandardError
+            false
+          end
+          { name: 'VS Code', path: path, configured: configured }
+        end
+      end
+    end
+  end
+end

data/lib/legion/cli.rb

@@ -41,6 +41,7 @@ module Legion
     autoload :Eval,       'legion/cli/eval_command'
     autoload :Update,     'legion/cli/update_command'
     autoload :Init,       'legion/cli/init_command'
+    autoload :Setup,      'legion/cli/setup_command'
     autoload :Skill,      'legion/cli/skill_command'
     autoload :Prompt,     'legion/cli/prompt_command'
     autoload :Image,      'legion/cli/image_command'
@@ -255,6 +256,9 @@ module Legion
       desc 'init', 'Initialize a new Legion workspace'
       subcommand 'init', Legion::CLI::Init
 
+      desc 'setup SUBCOMMAND', 'Set up Legion MCP integration for IDEs'
+      subcommand 'setup', Legion::CLI::Setup
+
       desc 'skill', 'Manage skills (.legion/skills/ markdown files)'
       subcommand 'skill', Legion::CLI::Skill
 

data/lib/legion/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Legion
-  VERSION = '1.4.118'
+  VERSION = '1.4.119'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legionio
 version: !ruby/object:Gem::Version
-  version: 1.4.118
+  version: 1.4.119
 platform: ruby
 authors:
 - Esity
@@ -575,6 +575,7 @@ files:
 - lib/legion/cli/relationship.rb
 - lib/legion/cli/review_command.rb
 - lib/legion/cli/schedule_command.rb
+- lib/legion/cli/setup_command.rb
 - lib/legion/cli/skill_command.rb
 - lib/legion/cli/start.rb
 - lib/legion/cli/status.rb