stakwork-cli 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c532528e8fdf9e6ce51774140b9d9b35e30a5aa9d2ef178e2ea211fe5692b974
+  data.tar.gz: 0be1d458ffd97d73ac60f7256da4bb151a29c891b3432e092f325e608dd8263e
+SHA512:
+  metadata.gz: 83f75216f8be15134d037be12848ccaae6654ac8cb4c76a24445f42eb56e8839ceb7cb3f2d9d2b0fa8f00aec6d1575d261db328ac42232c0690ca4d9489845a6
+  data.tar.gz: b7bb3fbcb4d6219f9f64cb77011e70c693b86b03e0b2c091a873ec9e5e90632684ca2e0c8a551a31b6b6ab4090a38241384979ef0c380406bb853e696c95bc10

data/bin/stakwork

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+$LOAD_PATH.unshift File.join(__dir__, '../lib')
+require 'stakwork_cli'
+begin
+  StakworkCli::CLI.start(ARGV)
+rescue StakworkCli::ApiError => e
+  $stderr.puts e.body
+  exit 1
+end

data/lib/stakwork_cli/client.rb

@@ -0,0 +1,84 @@
+require 'net/http'
+require 'json'
+require 'uri'
+
+module StakworkCli
+  class ApiError < StandardError
+    attr_reader :status, :body
+
+    def initialize(status, body)
+      @status = status
+      @body = body
+      super("API error #{status}: #{body}")
+    end
+  end
+
+  class Client
+    def initialize(token:, base_url:)
+      @token    = token
+      @base_url = base_url.chomp('/')
+      @uri      = URI.parse(@base_url)
+      warn_if_insecure
+    end
+
+    def get(path, params: {})
+      uri = build_uri(path, params)
+      request = Net::HTTP::Get.new(uri)
+      perform(request, uri)
+    end
+
+    def post(path, body: {})
+      uri = build_uri(path)
+      request = Net::HTTP::Post.new(uri)
+      request.body = body.to_json
+      perform(request, uri)
+    end
+
+    def put(path, body: {})
+      uri = build_uri(path)
+      request = Net::HTTP::Put.new(uri)
+      request.body = body.to_json
+      perform(request, uri)
+    end
+
+    def delete(path)
+      uri = build_uri(path)
+      request = Net::HTTP::Delete.new(uri)
+      perform(request, uri)
+    end
+
+    private
+
+    def build_uri(path, params = {})
+      uri = URI.parse("#{@base_url}#{path}")
+      unless params.empty?
+        uri.query = URI.encode_www_form(params.reject { |_, v| v.nil? })
+      end
+      uri
+    end
+
+    def perform(request, uri)
+      request['Content-Type']  = 'application/json'
+      request['Accept']        = 'application/json'
+      request['Authorization'] = "Token token=\"#{@token}\""
+
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = (uri.scheme == 'https')
+
+      response = http.request(request)
+
+      unless response.is_a?(Net::HTTPSuccess)
+        raise ApiError.new(response.code.to_i, response.body)
+      end
+
+      response.body
+    end
+
+    def warn_if_insecure
+      return if @uri.scheme == 'https'
+      host = @uri.host.to_s
+      return if host == 'localhost' || host == 'lvh.me' || host.start_with?('127.')
+      $stderr.puts 'Warning: connecting over HTTP to a non-local host. Consider using HTTPS.'
+    end
+  end
+end

data/lib/stakwork_cli/commands/auth.rb

@@ -0,0 +1,41 @@
+require 'thor'
+require 'json'
+require_relative '../config'
+
+module StakworkCli
+  module Commands
+    class Auth < Thor
+      desc 'login', 'Save credentials to ~/.stakwork/config.yml'
+      option :token, required: true, desc: 'API token'
+      option :host,  default: Config::DEFAULT_HOST, desc: 'API host URL'
+      def login
+        Config.save(token: options[:token], host: options[:host])
+        puts "✅ Credentials saved to ~/.stakwork/config.yml"
+        puts "   Host:  #{options[:host]}"
+        puts "   Token: #{mask_token(options[:token])}"
+      end
+
+      desc 'whoami', 'Show current configured credentials'
+      option :token,  desc: 'Inline token override'
+      option :host,   desc: 'Inline host override'
+      option :pretty, type: :boolean, default: false, desc: 'Pretty-print output'
+      def whoami
+        cfg = Config.load(token: options[:token], host: options[:host])
+        result = {
+          host:  cfg[:host],
+          token: mask_token(cfg[:token].to_s)
+        }
+        output = options[:pretty] ? JSON.pretty_generate(result) : result.to_json
+        puts output
+      end
+
+      private
+
+      def mask_token(token)
+        return '(not set)' if token.nil? || token.empty?
+        return token if token.length <= 8
+        "#{token[0, 4]}...#{token[-4..]}"
+      end
+    end
+  end
+end

data/lib/stakwork_cli/commands/customers.rb

@@ -0,0 +1,37 @@
+require 'thor'
+require 'json'
+require_relative '../config'
+require_relative '../client'
+
+module StakworkCli
+  module Commands
+    class Customers < Thor
+      class_option :token,  desc: 'API token (overrides config/env)'
+      class_option :host,   desc: 'API host (overrides config/env)'
+      class_option :pretty, type: :boolean, default: false, desc: 'Pretty-print JSON output'
+
+      desc 'create', 'Create a new customer'
+      option :name, required: true, desc: 'Customer name'
+      def create
+        body = { customer: { name: options[:name] } }
+        result = client.post('/api/v1/customers', body: body)
+        print_output(result)
+      end
+
+      private
+
+      def client
+        cfg = Config.load(token: options[:token], host: options[:host])
+        Client.new(token: cfg[:token], base_url: cfg[:host])
+      end
+
+      def print_output(raw)
+        if options[:pretty]
+          puts JSON.pretty_generate(JSON.parse(raw))
+        else
+          puts raw
+        end
+      end
+    end
+  end
+end

data/lib/stakwork_cli/commands/projects.rb

@@ -0,0 +1,76 @@
+require 'thor'
+require 'json'
+require_relative '../config'
+require_relative '../client'
+
+module StakworkCli
+  module Commands
+    class Projects < Thor
+      class_option :token,  desc: 'API token (overrides config/env)'
+      class_option :host,   desc: 'API host (overrides config/env)'
+      class_option :pretty, type: :boolean, default: false, desc: 'Pretty-print JSON output'
+
+      desc 'status ID', 'Get the status of a project run'
+      def status(id)
+        result = client.get("/api/v1/projects/#{id}/status")
+        print_output(result)
+      end
+
+      desc 'steps ID', 'Get the steps of a project run'
+      option :page,    type: :numeric, desc: 'Page number'
+      option :'step-id', type: :numeric, desc: 'Filter by step ID'
+      def steps(id)
+        params = {}
+        params[:page]    = options[:page]    if options[:page]
+        params[:step_id] = options[:'step-id'] if options[:'step-id']
+        result = client.get("/api/v1/projects/#{id}/steps", params: params)
+        print_output(result)
+      end
+
+      desc 'retry ID', 'Retry a failed project run'
+      def retry(id)
+        result = client.post("/api/v1/projects/#{id}/retry")
+        print_output(result)
+      end
+
+      desc 'stop ID', 'Stop a running project'
+      def stop(id)
+        result = client.post("/api/v1/projects/#{id}/stop")
+        print_output(result)
+      end
+
+      desc 'pause ID', 'Pause a running project'
+      option :reason, desc: 'Reason for pausing'
+      def pause(id)
+        body = {}
+        body[:reason] = options[:reason] if options[:reason]
+        result = client.post("/api/v1/projects/#{id}/pause", body: body)
+        print_output(result)
+      end
+
+      desc 'resume ID', 'Resume a paused project'
+      option :instructions, desc: 'Instructions for resuming'
+      def resume(id)
+        body = {}
+        body[:instructions] = options[:instructions] if options[:instructions]
+        result = client.post("/api/v1/projects/#{id}/resume", body: body)
+        print_output(result)
+      end
+
+      private
+
+      def client
+        cfg = Config.load(token: options[:token], host: options[:host])
+        Client.new(token: cfg[:token], base_url: cfg[:host])
+      end
+
+      def print_output(raw)
+        if options[:pretty]
+          puts JSON.pretty_generate(JSON.parse(raw))
+        else
+          puts raw
+        end
+      end
+    end
+  end
+end

data/lib/stakwork_cli/commands/prompts.rb

@@ -0,0 +1,71 @@
+require 'thor'
+require 'json'
+require_relative '../config'
+require_relative '../client'
+
+module StakworkCli
+  module Commands
+    class Prompts < Thor
+      class_option :token,  desc: 'API token (overrides config/env)'
+      class_option :host,   desc: 'API host (overrides config/env)'
+      class_option :pretty, type: :boolean, default: false, desc: 'Pretty-print JSON output'
+
+      desc 'list', 'List all prompts'
+      def list
+        result = client.get('/api/v1/prompts')
+        print_output(result)
+      end
+
+      desc 'show ID', 'Show a prompt by ID'
+      def show(id)
+        result = client.get("/api/v1/prompts/#{id}")
+        print_output(result)
+      end
+
+      desc 'create', 'Create a new prompt'
+      option :name,  required: true, desc: 'Prompt name'
+      option :value, required: true, desc: 'Prompt value/body'
+      def create
+        body = { prompt: { name: options[:name], value: options[:value] } }
+        result = client.post('/api/v1/prompts', body: body)
+        print_output(result)
+      end
+
+      desc 'update ID', 'Update an existing prompt'
+      option :value, required: true, desc: 'New prompt value/body'
+      def update(id)
+        body = { prompt: { value: options[:value] } }
+        result = client.put("/api/v1/prompts/#{id}", body: body)
+        print_output(result)
+      end
+
+      desc 'delete ID', 'Delete a prompt'
+      def delete(id)
+        result = client.delete("/api/v1/prompts/#{id}")
+        print_output(result)
+      end
+
+      desc 'publish ID', 'Publish a specific version of a prompt'
+      option :version, required: true, desc: 'Version ID to publish'
+      def publish(id)
+        result = client.post("/api/v1/prompts/#{id}/versions/#{options[:version]}/publish")
+        print_output(result)
+      end
+
+      private
+
+      def client
+        cfg = Config.load(token: options[:token], host: options[:host])
+        Client.new(token: cfg[:token], base_url: cfg[:host])
+      end
+
+      def print_output(raw)
+        if options[:pretty]
+          puts JSON.pretty_generate(JSON.parse(raw))
+        else
+          puts raw
+        end
+      end
+    end
+  end
+end

data/lib/stakwork_cli/commands/skills.rb

@@ -0,0 +1,46 @@
+require 'thor'
+require 'json'
+require_relative '../config'
+require_relative '../client'
+
+module StakworkCli
+  module Commands
+    class Skills < Thor
+      class_option :token,  desc: 'API token (overrides config/env)'
+      class_option :host,   desc: 'API host (overrides config/env)'
+      class_option :pretty, type: :boolean, default: false, desc: 'Pretty-print JSON output'
+
+      desc 'list', 'List available skills'
+      option :search, desc: 'Filter by search query'
+      option :page,   type: :numeric, desc: 'Page number'
+      def list
+        params = {}
+        params[:search] = options[:search] if options[:search]
+        params[:page]   = options[:page]   if options[:page]
+        result = client.get('/api/v1/skills', params: params)
+        print_output(result)
+      end
+
+      desc 'examples ID', 'Show input/output examples for a skill'
+      def examples(id)
+        result = client.get("/api/v1/skills/#{id}/examples")
+        print_output(result)
+      end
+
+      private
+
+      def client
+        cfg = Config.load(token: options[:token], host: options[:host])
+        Client.new(token: cfg[:token], base_url: cfg[:host])
+      end
+
+      def print_output(raw)
+        if options[:pretty]
+          puts JSON.pretty_generate(JSON.parse(raw))
+        else
+          puts raw
+        end
+      end
+    end
+  end
+end

data/lib/stakwork_cli/commands/workflows.rb

@@ -0,0 +1,104 @@
+require 'thor'
+require 'json'
+require_relative '../config'
+require_relative '../client'
+
+module StakworkCli
+  module Commands
+    class Workflows < Thor
+      class_option :token,  desc: 'API token (overrides config/env)'
+      class_option :host,   desc: 'API host (overrides config/env)'
+      class_option :pretty, type: :boolean, default: false, desc: 'Pretty-print JSON output'
+
+      desc 'list', 'List workflows'
+      option :page, type: :numeric, default: 1, desc: 'Page number'
+      def list
+        result = client.get('/api/v1/workflows', params: { page: options[:page] })
+        print_output(result)
+      end
+
+      desc 'search QUERY', 'Search workflows by name'
+      def search(query)
+        result = client.get('/api/v1/workflows/search', params: { search: query })
+        print_output(result)
+      end
+
+      desc 'show ID', 'Show a workflow by ID'
+      def show(id)
+        result = client.get("/api/v1/workflows/#{id}")
+        print_output(result)
+      end
+
+      desc 'create', 'Create a new workflow'
+      option :workflow, required: true, desc: 'JSON workflow definition'
+      option :'child-workflows', desc: 'JSON array of child workflow definitions'
+      def create
+        begin
+          workflow = JSON.parse(options[:workflow])
+        rescue JSON::ParserError => e
+          $stderr.puts "Error: --workflow is not valid JSON: #{e.message}"
+          exit 1
+        end
+
+        body = { workflow: workflow }
+
+        if options[:'child-workflows']
+          begin
+            body[:child_workflows] = JSON.parse(options[:'child-workflows'])
+          rescue JSON::ParserError => e
+            $stderr.puts "Error: --child-workflows is not valid JSON: #{e.message}"
+            exit 1
+          end
+        end
+
+        result = client.post('/api/v1/workflows', body: body)
+        print_output(result)
+      end
+
+      desc 'publish ID', 'Publish a workflow'
+      def publish(id)
+        result = client.post("/api/v1/workflows/#{id}/publish")
+        print_output(result)
+      end
+
+      desc 'run ID', 'Trigger a workflow run'
+      option :name,   required: true, desc: 'Name for this run'
+      option :params, default: '{}',  desc: 'JSON workflow params'
+      def trigger(id)
+        begin
+          workflow_params = JSON.parse(options[:params])
+        rescue JSON::ParserError => e
+          $stderr.puts "Error: --params is not valid JSON: #{e.message}"
+          exit 1
+        end
+
+        body = {
+          project: {
+            workflow_id:     id.to_i,
+            name:            options[:name],
+            workflow_params: workflow_params
+          }
+        }
+        result = client.post('/api/v1/projects', body: body)
+        print_output(result)
+      end
+
+      map 'run' => :trigger
+
+      private
+
+      def client
+        cfg = Config.load(token: options[:token], host: options[:host])
+        Client.new(token: cfg[:token], base_url: cfg[:host])
+      end
+
+      def print_output(raw)
+        if options[:pretty]
+          puts JSON.pretty_generate(JSON.parse(raw))
+        else
+          puts raw
+        end
+      end
+    end
+  end
+end

data/lib/stakwork_cli/config.rb

@@ -0,0 +1,43 @@
+require 'yaml'
+require 'fileutils'
+
+module StakworkCli
+  module Config
+    CONFIG_DIR  = File.expand_path('~/.stakwork')
+    CONFIG_PATH = File.join(CONFIG_DIR, 'config.yml')
+    DEFAULT_HOST = 'https://api.stakwork.com'
+
+    # Resolves token and host in precedence order:
+    #   1. Inline argument
+    #   2. Environment variable
+    #   3. ~/.stakwork/config.yml
+    #   4. Default host
+    def self.load(token: nil, host: nil)
+      file_config = load_file
+
+      resolved_token = token ||
+                       ENV['STAKWORK_TOKEN'] ||
+                       file_config['token']
+
+      resolved_host = host ||
+                      ENV['STAKWORK_HOST'] ||
+                      file_config['host'] ||
+                      DEFAULT_HOST
+
+      { token: resolved_token, host: resolved_host }
+    end
+
+    def self.save(token:, host:)
+      FileUtils.mkdir_p(CONFIG_DIR)
+      File.write(CONFIG_PATH, { 'token' => token, 'host' => host }.to_yaml)
+      File.chmod(0o600, CONFIG_PATH)
+    end
+
+    def self.load_file
+      return {} unless File.exist?(CONFIG_PATH)
+      YAML.safe_load(File.read(CONFIG_PATH)) || {}
+    rescue Psych::SyntaxError
+      {}
+    end
+  end
+end

data/lib/stakwork_cli/version.rb

@@ -0,0 +1,3 @@
+module StakworkCli
+  VERSION = '0.1.0'
+end

data/lib/stakwork_cli.rb

@@ -0,0 +1,48 @@
+require 'thor'
+require_relative 'stakwork_cli/version'
+require_relative 'stakwork_cli/config'
+require_relative 'stakwork_cli/client'
+require_relative 'stakwork_cli/commands/auth'
+require_relative 'stakwork_cli/commands/workflows'
+require_relative 'stakwork_cli/commands/projects'
+require_relative 'stakwork_cli/commands/prompts'
+require_relative 'stakwork_cli/commands/skills'
+require_relative 'stakwork_cli/commands/customers'
+
+module StakworkCli
+  class CLI < Thor
+    desc 'login', 'Save API credentials to ~/.stakwork/config.yml'
+    option :token, required: true, desc: 'API token'
+    option :host,  default: Config::DEFAULT_HOST, desc: 'API host URL'
+    def login
+      Commands::Auth.new.invoke(:login, [], options.to_h.transform_keys(&:to_sym))
+    end
+
+    desc 'whoami', 'Show current configured credentials'
+    option :token,  desc: 'Inline token override'
+    option :host,   desc: 'Inline host override'
+    option :pretty, type: :boolean, default: false, desc: 'Pretty-print output'
+    def whoami
+      Commands::Auth.new.invoke(:whoami, [], options.to_h.transform_keys(&:to_sym))
+    end
+
+    desc 'workflows SUBCOMMAND', 'Manage workflows'
+    subcommand 'workflows', Commands::Workflows
+
+    desc 'projects SUBCOMMAND', 'Manage project runs'
+    subcommand 'projects', Commands::Projects
+
+    desc 'prompts SUBCOMMAND', 'Manage prompts'
+    subcommand 'prompts', Commands::Prompts
+
+    desc 'skills SUBCOMMAND', 'Browse skills'
+    subcommand 'skills', Commands::Skills
+
+    desc 'customers SUBCOMMAND', 'Manage customers'
+    subcommand 'customers', Commands::Customers
+
+    def self.exit_on_failure?
+      true
+    end
+  end
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification
+name: stakwork-cli
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Stakwork
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-03-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+description: A command-line interface for interacting with the Stakwork REST API.
+  Manage workflows, projects, prompts, and skills from the terminal.
+email:
+executables:
+- stakwork
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/stakwork
+- lib/stakwork_cli.rb
+- lib/stakwork_cli/client.rb
+- lib/stakwork_cli/commands/auth.rb
+- lib/stakwork_cli/commands/customers.rb
+- lib/stakwork_cli/commands/projects.rb
+- lib/stakwork_cli/commands/prompts.rb
+- lib/stakwork_cli/commands/skills.rb
+- lib/stakwork_cli/commands/workflows.rb
+- lib/stakwork_cli/config.rb
+- lib/stakwork_cli/version.rb
+homepage:
+licenses: []
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.33
+signing_key:
+specification_version: 4
+summary: CLI for the Stakwork API
+test_files: []