wokku-cli 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3d6db99db4bf59f5b55f619cbd6abb12fc6b3f711fba103b327e6d0b01479114
+  data.tar.gz: 0b10a6ea71101885f3929f7f6055705b6a0d98ebcb2a21147070911c0522b24a
+SHA512:
+  metadata.gz: 8b3e284c92712469309c2a3aab4fffa60e26b89727f8bf948e1bfaba87e70b572eca298ec69ee1449d6112656d478294c825f1d826b0a7f9d2f7a02b57820085
+  data.tar.gz: e3f998fd1ec992942da0319c4838cf664dbbda1ef49cb9a777a35da0acc3d1a29ec0486df464f5b45bd3d9cc3eb431098e23b7bb047462d1fc6a27d90f26772d

data/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+## 0.1.0 — 2026-05-04
+
+First public release on RubyGems.
+
+The wokku CLI was previously distributed as a tarball from `wokku.cloud/cli/wokku.tar.gz`. This is a fresh start under the `0.x` line — pre-1.0 means the surface may evolve as we gather feedback. Reach 1.0.0 once the API stabilizes.
+
+### Features
+- Apps: `apps`, `apps:create`, `apps:destroy`, `apps:info`
+- Process: `ps:start/stop/restart/scale/rebuild`, `redeploy`
+- Config: `config`, `config:set/get/unset`, `config:export` (.env-safe quoting)
+- Domains: `domains`, `domains:add/remove/clear`, `certs:enable`
+- Buildpacks: `buildpacks`, `buildpacks:add/remove/clear/set`
+- Health checks: `checks`, `checks:set`
+- Storage: `storage`, `storage:mount/unmount`
+- Releases: `releases`, `rollback`
+- Add-ons: `addons`, `addons:add`
+- Templates: `templates`, `deploy`
+- Activity: `activity`
+- Logs: `logs` with `--follow` / `-f` streaming
+- SSH keys: `ssh-keys`, `ssh-keys:add/remove`
+- Servers: `servers`, `servers:info`, `servers:default`
+- Databases: `databases`, `databases:create/destroy/info/link/unlink`
+- One-off: `wokku run APP -- COMMAND` (in-container)
+- Passthrough: `wokku do APP -- DOKKU_ARGS` (raw dokku command, audit-logged)
+- Authentication: `auth:login`, `auth:logout`, `auth:whoami`
+- Global flags: `--json` (machine-readable), `--quiet` / `-q`
+
+### Distribution
+- Install: `gem install wokku-cli` or `brew install johannesdwicahyo/tap/wokku`
+- Source: <https://github.com/johannesdwicahyo/wokku-cli>
+- Old `curl install.sh` flow continues to work (delegates to `gem install wokku-cli`).

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Johannes Dwicahyo
+
+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,48 @@
+# wokku-cli
+
+CLI for [Wokku](https://wokku.cloud) — deploy and manage apps, databases, domains, and SSH keys on Wokku.cloud or self-hosted Wokku servers.
+
+## Install
+
+```sh
+gem install wokku-cli
+```
+
+Or via Homebrew:
+
+```sh
+brew install johannesdwicahyo/tap/wokku
+```
+
+## Quick start
+
+```sh
+wokku auth:login
+wokku apps
+wokku apps:create myapp
+wokku ps:restart myapp
+wokku logs myapp -f
+```
+
+## Commands
+
+Run `wokku --help` for the full list. Highlights:
+
+- **Apps:** `apps`, `apps:create`, `apps:destroy`, `apps:info`
+- **Process:** `ps:start/stop/restart/scale/rebuild`, `redeploy`
+- **Config:** `config`, `config:set`, `config:get`, `config:unset`, `config:export`
+- **Domains:** `domains`, `domains:add/remove/clear`, `certs:enable`
+- **Databases:** `databases`, `databases:create/destroy/link/unlink/info`
+- **SSH keys:** `ssh-keys`, `ssh-keys:add/remove`
+- **Servers:** `servers`, `servers:info`, `servers:default`
+- **Logs:** `wokku logs APP --follow`
+- **Run / passthrough:** `wokku run APP -- COMMAND`, `wokku do APP -- DOKKU_ARGS`
+
+## Global flags
+
+- `--json` — machine-readable JSON output (read commands)
+- `--quiet` / `-q` — suppress success messages and hints
+
+## License
+
+MIT — see [LICENSE](LICENSE).

data/exe/wokku

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+require "wokku"
+exit Wokku::CLI.dispatch(ARGV)

data/lib/wokku/api_client.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+require "json"
+require "net/http"
+require "uri"
+require_relative "config"
+
+module Wokku
+  class ApiClient
+    class Error < StandardError; end
+    class NotAuthenticated < Error; end
+    class Timeout < Error; end
+    class Unreachable < Error; end
+
+    OPEN_TIMEOUT = 10
+    READ_TIMEOUT = 30
+
+    def initialize(url: nil, token: nil, user_agent: "WokkuCLI")
+      @url = url
+      @token = token
+      @user_agent = user_agent
+    end
+
+    def get(path)         = request(:get, path)
+    def post(path, body = nil)   = request(:post, path, body)
+    def put(path, body = nil)    = request(:put, path, body)
+    def patch(path, body = nil)  = request(:patch, path, body)
+    def delete(path, body = nil) = request(:delete, path, body)
+
+    def request(method, path, body = nil)
+      @last_path = path
+      raise NotAuthenticated, "Not logged in. Run: wokku auth:login" unless token
+
+      uri = URI("#{url}#{path}")
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+      http.open_timeout = OPEN_TIMEOUT
+      http.read_timeout = READ_TIMEOUT
+
+      req = build_request(method, uri)
+      req["Authorization"] = "Bearer #{token}"
+      req["Content-Type"] = "application/json"
+      req["User-Agent"] = @user_agent
+      req.body = body.to_json if body
+
+      resp = perform(http, req, uri)
+      parse_response(resp)
+    end
+
+    def stream(method, path, &block)
+      @last_path = path
+      raise NotAuthenticated, "Not logged in. Run: wokku auth:login" unless token
+
+      uri = URI("#{url}#{path}")
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+      # Local Net::HTTP instance — disabling read_timeout doesn't leak to other calls.
+      http.read_timeout = nil
+
+      req = build_request(method, uri)
+      req["Authorization"] = "Bearer #{token}"
+      req["Accept"] = "text/plain"
+      req["User-Agent"] = @user_agent
+
+      http.request(req) do |resp|
+        raise Error, "Stream failed: HTTP #{resp.code}" unless resp.is_a?(Net::HTTPSuccess)
+        resp.read_body { |chunk| block.call(chunk) }
+      end
+    rescue Interrupt
+      # Ctrl-C — exit gracefully
+    end
+
+    private
+
+    def url
+      @url || Wokku::Config.api_url
+    end
+
+    def token
+      @token || Wokku::Config.api_token
+    end
+
+    def build_request(method, uri)
+      case method
+      when :get    then Net::HTTP::Get.new(uri)
+      when :post   then Net::HTTP::Post.new(uri)
+      when :put    then Net::HTTP::Put.new(uri)
+      when :patch  then Net::HTTP::Patch.new(uri)
+      when :delete then Net::HTTP::Delete.new(uri)
+      else raise ArgumentError, "Unsupported method: #{method}"
+      end
+    end
+
+    def perform(http, req, uri)
+      http.request(req)
+    rescue Net::ReadTimeout, Net::OpenTimeout
+      raise Timeout, "Request timed out — the server didn't respond in #{READ_TIMEOUT}s."
+    rescue SocketError => e
+      raise Unreachable, "Cannot reach #{uri.host}: #{e.message.lines.first&.strip}."
+    rescue Errno::ECONNREFUSED
+      raise Unreachable, "Connection refused by #{uri.host}:#{uri.port}."
+    rescue OpenSSL::SSL::SSLError => e
+      raise Unreachable, "TLS error talking to #{uri.host}: #{e.message.lines.first&.strip}."
+    end
+
+    def parse_response(resp)
+      data = JSON.parse(resp.body) rescue resp.body
+      return data if resp.is_a?(Net::HTTPSuccess)
+
+      raise Error, friendly_error(resp, data)
+    end
+
+    def friendly_error(resp, data)
+      if resp.code == "404" && (req_path = @last_path) && (m = req_path.match(%r{\A/apps/([^/?]+)}))
+        return "No app named '#{m[1]}'"
+      end
+      msg = data.is_a?(Hash) ? (data["error"] || data["errors"]&.join(", ") || resp.code) : resp.code
+      "Error: #{msg}"
+    end
+  end
+end

data/lib/wokku/commands/activity.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# --- Activity ---
+register "activity", "Show recent activity" do
+  data = api(:get, "/activities?limit=20")
+  Wokku::Output.render(data) do |d|
+    if d.is_a?(Array)
+      d.each { |a| puts "#{a['created_at'].to_s[0..18]}  #{a['action']}  #{a['target_name']}" }
+    else
+      puts_json d
+    end
+  end
+end

data/lib/wokku/commands/addons.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+# --- Add-ons ---
+register "addons", "List add-ons (usage: wokku addons APP)" do
+  id = ARGV.shift || abort("Usage: wokku addons APP")
+  data = api(:get, "/apps/#{id}/addons")
+  Wokku::Output.render(data) do |d|
+    if d.is_a?(Array)
+      table(d.map { |a| { "name" => a["name"], "type" => a["service_type"], "status" => a["status"] } })
+    else
+      puts_json d
+    end
+  end
+end
+
+register "addons:add", "Add add-on (usage: wokku addons:add APP postgres)" do
+  id = ARGV.shift || abort("Usage: wokku addons:add APP SERVICE_TYPE")
+  service_type = ARGV.shift || abort("Missing service type (postgres, redis, mysql, etc)")
+  name = nil
+  while arg = ARGV.shift
+    name = ARGV.shift if arg == "--name"
+  end
+  body = { service_type: service_type }
+  body[:name] = name if name
+  data = api(:post, "/apps/#{id}/addons", body)
+  Wokku::Output.status "Added #{service_type}: #{data['name'] || data['id']}"
+end

data/lib/wokku/commands/apps.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+# --- Apps ---
+register "apps", "List all apps" do
+  apps = api(:get, "/apps")
+  Wokku::Output.render(apps) do |list|
+    table(list.map { |a| { "name" => a["name"], "status" => a["status"], "server" => a["server_id"] } })
+  end
+end
+
+register "apps:info", "Show app details (usage: wokku apps:info APP)" do
+  id = ARGV.shift || abort("Usage: wokku apps:info APP")
+  data = api(:get, "/apps/#{id}")
+  Wokku::Output.render(data) { |d| puts_json d }
+end
+
+register "apps:create", "Create app (usage: wokku apps:create NAME [--server SERVER] [--branch BRANCH])" do
+  name = ARGV.shift || abort("Usage: wokku apps:create NAME [--server SERVER]")
+  server = nil
+  branch = "main"
+  while arg = ARGV.shift
+    case arg
+    when "--server" then server = ARGV.shift
+    when "--branch" then branch = ARGV.shift
+    end
+  end
+  server = resolve_server(explicit: server)
+  data = api(:post, "/apps", { name: name, server_id: server, deploy_branch: branch })
+  Wokku::Output.status "Created app: #{data['name']} (id: #{data['id']})"
+end
+
+register "apps:destroy", "Delete app (usage: wokku apps:destroy APP)" do
+  id = ARGV.shift || abort("Usage: wokku apps:destroy APP")
+  print "Are you sure you want to delete this app? (y/N): "
+  confirm = $stdin.gets.strip
+  abort "Cancelled." unless confirm.downcase == "y"
+  api(:delete, "/apps/#{id}")
+  Wokku::Output.status "App deleted."
+end

data/lib/wokku/commands/auth.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+# --- Auth ---
+register "auth:login", "Authenticate with Wokku" do
+  print "Wokku API URL [https://wokku.cloud/api/v1]: "
+  url = $stdin.gets.strip
+  url = "https://wokku.cloud/api/v1" if url.empty?
+
+  print "Email: "
+  email = $stdin.gets.strip
+  print "Password: "
+  password = ($stdin.respond_to?(:noecho) ? $stdin.noecho(&:gets) : $stdin.gets).strip
+  puts
+
+  uri = URI("#{url}/auth/login")
+  http = Net::HTTP.new(uri.host, uri.port)
+  http.use_ssl = uri.scheme == "https"
+  req = Net::HTTP::Post.new(uri)
+  req["Content-Type"] = "application/json"
+  req.body = { email: email, password: password }.to_json
+
+  resp = http.request(req)
+  data = JSON.parse(resp.body) rescue {}
+
+  if resp.is_a?(Net::HTTPSuccess) && data["token"]
+    save_config({ "api_url" => url, "token" => data["token"], "email" => email })
+    instance = url.include?("wokku.cloud") ? "wokku.cloud (managed)" : "#{URI(url).host} (self-hosted)"
+    Wokku::Output.status "Logged in as #{email}"
+    Wokku::Output.status "Connected to: #{instance}"
+  else
+    abort "Login failed: #{data['error'] || resp.code}"
+  end
+end
+
+register "auth:logout", "Log out" do
+  path = Wokku::Config.file
+  if File.exist?(path)
+    File.delete(path)
+    Wokku::Output.status "Logged out."
+  else
+    Wokku::Output.status "Not logged in."
+  end
+end
+
+register "auth:whoami", "Show current user" do
+  data = api(:get, "/auth/whoami")
+  Wokku::Output.render(data) do |d|
+    puts "Email: #{d['email']}"
+    puts "Role:  #{d['role']}"
+  end
+end

data/lib/wokku/commands/buildpacks.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+# --- Buildpacks ---
+register "buildpacks", "List buildpacks (usage: wokku buildpacks APP)" do
+  id = ARGV.shift || abort("Usage: wokku buildpacks APP")
+  data = api(:get, "/apps/#{id}/buildpacks")
+  Wokku::Output.render(data) do |d|
+    list = d.is_a?(Hash) ? Array(d["buildpacks"]) : Array(d)
+    if list.empty?
+      puts "(no buildpacks configured — auto-detected from source)"
+    else
+      list.each_with_index { |url, i| puts "#{i + 1}. #{url}" }
+    end
+  end
+end
+
+register "buildpacks:add", "Append a buildpack (usage: wokku buildpacks:add APP URL [--index N])" do
+  id = ARGV.shift || abort("Usage: wokku buildpacks:add APP URL [--index N]")
+  url = ARGV.shift || abort("Missing buildpack URL")
+  index = nil
+  while arg = ARGV.shift
+    index = ARGV.shift if arg == "--index"
+  end
+  body = { url: url }
+  body[:index] = index if index
+  api(:post, "/apps/#{id}/buildpacks", body)
+  Wokku::Output.status "Added buildpack: #{url}"
+end
+
+register "buildpacks:remove", "Remove a buildpack (usage: wokku buildpacks:remove APP URL)" do
+  id = ARGV.shift || abort("Usage: wokku buildpacks:remove APP URL")
+  url = ARGV.shift || abort("Missing buildpack URL")
+  api(:delete, "/apps/#{id}/buildpacks", { url: url })
+  Wokku::Output.status "Removed buildpack: #{url}"
+end
+
+register "buildpacks:clear", "Remove every buildpack (usage: wokku buildpacks:clear APP)" do
+  id = ARGV.shift || abort("Usage: wokku buildpacks:clear APP")
+  api(:delete, "/apps/#{id}/buildpacks")
+  Wokku::Output.status "All buildpacks removed."
+end
+
+register "buildpacks:set", "Replace the buildpack stack in order (usage: wokku buildpacks:set APP URL [URL...])" do
+  id = ARGV.shift || abort("Usage: wokku buildpacks:set APP URL [URL...]")
+  urls = ARGV.dup
+  ARGV.clear
+  abort "No buildpack URLs given." if urls.empty?
+  api(:put, "/apps/#{id}/buildpacks", { urls: urls })
+  Wokku::Output.status "Buildpacks set: #{urls.join(', ')}"
+end

data/lib/wokku/commands/certs.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+# --- TLS / Certs ---
+register "certs:enable", "Enable Let's Encrypt SSL on a domain (usage: wokku certs:enable APP DOMAIN)" do
+  id = ARGV.shift || abort("Usage: wokku certs:enable APP DOMAIN")
+  domain = ARGV.shift || abort("Missing domain name")
+  row = find_domain(id, domain) || abort("No domain '#{domain}' on app #{id} — add it first with wokku domains:add")
+  api(:post, "/apps/#{id}/domains/#{row['id']}/ssl")
+  Wokku::Output.status "SSL enabled for #{domain}"
+end

data/lib/wokku/commands/checks.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+# --- Health checks ---
+register "checks", "Show Dokku health check config (usage: wokku checks APP)" do
+  id = ARGV.shift || abort("Usage: wokku checks APP")
+  data = api(:get, "/apps/#{id}/checks")
+  Wokku::Output.render(data) { |d| puts_json d }
+end
+
+register "checks:set", "Update health check settings (usage: wokku checks:set APP [--enabled BOOL] [--wait N] [--timeout N] [--attempts N] [--path PATH])" do
+  id = ARGV.shift || abort("Usage: wokku checks:set APP [flags]")
+  body = {}
+  while arg = ARGV.shift
+    case arg
+    when "--enabled"   then body[:enabled]  = ARGV.shift
+    when "--wait"      then body[:wait]     = ARGV.shift
+    when "--timeout"   then body[:timeout]  = ARGV.shift
+    when "--attempts"  then body[:attempts] = ARGV.shift
+    when "--path"      then body[:path]     = ARGV.shift
+    end
+  end
+  abort "No flags given. Try --enabled true, --path /healthz, --wait 5, etc." if body.empty?
+  api(:put, "/apps/#{id}/checks", body)
+  Wokku::Output.status "Health check settings updated."
+end

data/lib/wokku/commands/config.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+# --- Config ---
+register "config", "Show config vars (usage: wokku config APP)" do
+  id = ARGV.shift || abort("Usage: wokku config APP")
+  data = api(:get, "/apps/#{id}/config")
+  Wokku::Output.render(data) do |d|
+    if d.is_a?(Hash)
+      d.each { |k, v| puts "#{k}=#{v}" }
+    else
+      puts_json d
+    end
+  end
+end
+
+register "config:set", "Set config vars (usage: wokku config:set APP KEY=VAL ...)" do
+  id = ARGV.shift || abort("Usage: wokku config:set APP KEY=VALUE ...")
+  vars = {}
+  ARGV.each do |pair|
+    key, val = pair.split("=", 2)
+    vars[key] = val if key && val
+  end
+  ARGV.clear
+  abort "No KEY=VALUE pairs given." if vars.empty?
+  # Server expects { vars: { K: V } }, not the bare hash. Sending the bare
+  # hash worked previously because Rails was permissive; the controller
+  # actually reads params[:vars].
+  api(:put, "/apps/#{id}/config", { vars: vars })
+  Wokku::Output.status "Config updated: #{vars.keys.join(', ')}"
+  Wokku::Output.status "Restart the app to pick up changes: wokku ps:restart #{id}"
+end
+
+register "config:get", "Show one config var (usage: wokku config:get APP KEY)" do
+  id = ARGV.shift || abort("Usage: wokku config:get APP KEY")
+  key = ARGV.shift || abort("Missing KEY")
+  data = api(:get, "/apps/#{id}/config")
+  vars = data.is_a?(Hash) ? (data["config"] || data) : {}
+  abort "Key not set: #{key}" unless vars.key?(key)
+  Wokku::Output.render({ "key" => key, "value" => vars[key] }) { |_| puts vars[key] }
+end
+
+register "config:export", "Export config as .env (usage: wokku config:export APP)" do
+  id = ARGV.shift || abort("Usage: wokku config:export APP")
+  data = api(:get, "/apps/#{id}/config")
+  vars = data.is_a?(Hash) ? (data["config"] || data) : {}
+  Wokku::Output.render(vars) do |d|
+    d.each do |k, v|
+      escaped = v.to_s.gsub('\\') { '\\\\' }.gsub('"') { '\\"' }
+      puts %Q(#{k}="#{escaped}")
+    end
+  end
+end
+
+register "config:unset", "Remove config vars (usage: wokku config:unset APP KEY [KEY...])" do
+  id = ARGV.shift || abort("Usage: wokku config:unset APP KEY [KEY...]")
+  keys = ARGV.dup
+  ARGV.clear
+  abort "No KEYs given." if keys.empty?
+  api(:delete, "/apps/#{id}/config", { keys: keys })
+  Wokku::Output.status "Removed: #{keys.join(', ')}"
+  Wokku::Output.status "Restart the app to pick up changes: wokku ps:restart #{id}"
+end

data/lib/wokku/commands/databases.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+# --- Databases ---
+register "databases", "List your databases" do
+  data = api(:get, "/databases")
+  Wokku::Output.render(data) do |list|
+    table(Array(list).map { |db| {
+      "name" => db["name"],
+      "type" => db["service_type"],
+      "status" => db["status"],
+      "server" => db["server_id"]
+    } })
+  end
+end
+
+register "databases:info", "Show database details (usage: wokku databases:info NAME)" do
+  name = ARGV.shift || abort("Usage: wokku databases:info NAME")
+  data = api(:get, "/databases/#{name}")
+  Wokku::Output.render(data) { |d| puts_json d }
+end
+
+register "databases:create", "Create a database (usage: wokku databases:create NAME --type TYPE [--server SERVER])" do
+  name = ARGV.shift || abort("Usage: wokku databases:create NAME --type TYPE [--server SERVER]")
+  type = nil
+  server = nil
+  while arg = ARGV.shift
+    case arg
+    when "--type"   then type = ARGV.shift
+    when "--server" then server = ARGV.shift
+    end
+  end
+  abort "Missing --type (postgres, mysql, redis, mongo)" unless type
+  server = resolve_server(explicit: server)
+  data = api(:post, "/databases", { name: name, service_type: type, server_id: server })
+  Wokku::Output.status "Created #{data['service_type']} database: #{data['name']}"
+end
+
+register "databases:destroy", "Destroy a database (usage: wokku databases:destroy NAME)" do
+  name = ARGV.shift || abort("Usage: wokku databases:destroy NAME")
+  print "Are you sure you want to destroy database '#{name}'? (y/N): "
+  confirm = $stdin.gets.to_s.strip
+  abort "Cancelled." unless confirm.downcase == "y"
+  api(:delete, "/databases/#{name}")
+  Wokku::Output.status "Database '#{name}' destroyed."
+end
+
+register "databases:link", "Link a database to an app (usage: wokku databases:link DB APP [--alias ALIAS])" do
+  db_name = ARGV.shift || abort("Usage: wokku databases:link DB APP [--alias ALIAS]")
+  app = ARGV.shift || abort("Missing APP")
+  alias_name = nil
+  while arg = ARGV.shift
+    case arg
+    when "--alias" then alias_name = ARGV.shift
+    end
+  end
+  body = { app_id: app }
+  body[:alias_name] = alias_name if alias_name
+  api(:post, "/databases/#{db_name}/link", body)
+  Wokku::Output.status "Linked '#{db_name}' to '#{app}'#{alias_name ? " as #{alias_name}" : ""}."
+end
+
+register "databases:unlink", "Unlink a database from an app (usage: wokku databases:unlink DB APP)" do
+  db_name = ARGV.shift || abort("Usage: wokku databases:unlink DB APP")
+  app = ARGV.shift || abort("Missing APP")
+  api(:post, "/databases/#{db_name}/unlink", { app_id: app })
+  Wokku::Output.status "Unlinked '#{db_name}' from '#{app}'."
+end

data/lib/wokku/commands/do.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+# --- Raw dokku passthrough ---
+register "do", "Run any dokku command (usage: wokku do APP -- DOKKU_ARGS  |  wokku do --server N -- DOKKU_ARGS)" do
+  app    = nil
+  server = nil
+  force  = false
+  while ARGV.any? && ARGV.first != "--"
+    arg = ARGV.shift
+    case arg
+    when "--server"
+      server = ARGV.shift
+      abort "--server requires a server ID" if server.nil? || server == "--"
+    when "--force"  then force = true
+    else app ||= arg
+    end
+  end
+
+  abort "Missing `--` separator. Example: wokku do myapp -- ps:list" unless ARGV.first == "--"
+  ARGV.shift  # drop the --
+  args = ARGV.dup
+  ARGV.clear
+  abort "Missing dokku command. Example: wokku do myapp -- ps:list" if args.empty?
+  abort "Pass either APP or --server N, not both" if app && server
+  abort "Pass APP or --server N before --" if app.nil? && server.nil?
+
+  path = app ? "/apps/#{app}/dokku" : "/servers/#{server}/dokku"
+  data = api(:post, path, { args: args, force: force })
+  $stdout.write(data["stdout"]) if data["stdout"] && !data["stdout"].empty?
+  $stderr.write(data["stderr"]) if data["stderr"] && !data["stderr"].empty?
+  exit (data["exit_code"] || 0).to_i
+end

data/lib/wokku/commands/domains.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+# --- Domains ---
+register "domains", "List domains (usage: wokku domains APP)" do
+  id = ARGV.shift || abort("Usage: wokku domains APP")
+  data = api(:get, "/apps/#{id}/domains")
+  Wokku::Output.render(data) do |d|
+    if d.is_a?(Array)
+      d.each { |row| puts row["hostname"] || row }
+    else
+      puts_json d
+    end
+  end
+end
+
+register "domains:add", "Add domain (usage: wokku domains:add APP DOMAIN)" do
+  id = ARGV.shift || abort("Usage: wokku domains:add APP DOMAIN")
+  domain = ARGV.shift || abort("Missing domain name")
+  api(:post, "/apps/#{id}/domains", { hostname: domain })
+  Wokku::Output.status "Added domain: #{domain}"
+end
+
+register "domains:remove", "Remove a domain (usage: wokku domains:remove APP DOMAIN)" do
+  id = ARGV.shift || abort("Usage: wokku domains:remove APP DOMAIN")
+  domain = ARGV.shift || abort("Missing domain name")
+  row = find_domain(id, domain) || abort("No domain '#{domain}' on app #{id}")
+  api(:delete, "/apps/#{id}/domains/#{row['id']}")
+  Wokku::Output.status "Removed domain: #{domain}"
+end
+
+register "domains:clear", "Remove every custom domain on an app (usage: wokku domains:clear APP)" do
+  id = ARGV.shift || abort("Usage: wokku domains:clear APP")
+  list = api(:get, "/apps/#{id}/domains")
+  abort "No domains on app #{id}" unless list.is_a?(Array) && list.any?
+  list.each do |d|
+    api(:delete, "/apps/#{id}/domains/#{d['id']}")
+    Wokku::Output.status "Removed: #{d['hostname']}"
+  end
+end

data/lib/wokku/commands/logs.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+# --- Logs ---
+register "logs", "View logs (usage: wokku logs APP [--lines N] [--follow|-f])" do
+  id = ARGV.shift || abort("Usage: wokku logs APP")
+  lines = 100
+  follow = false
+  while arg = ARGV.shift
+    case arg
+    when "--lines"        then lines = ARGV.shift.to_i
+    when "--follow", "-f" then follow = true
+    end
+  end
+
+  if follow
+    Wokku.api_client.stream(:get, "/apps/#{id}/logs?follow=1") do |chunk|
+      $stdout.write(chunk)
+      $stdout.flush
+    end
+  else
+    data = api(:get, "/apps/#{id}/logs?lines=#{lines}")
+    Wokku::Output.render(data) do |d|
+      if d.is_a?(Array)
+        d.each { |l| puts l }
+      elsif d.is_a?(Hash) && d["logs"]
+        puts d["logs"]
+      else
+        puts_json d
+      end
+    end
+  end
+end

data/lib/wokku/commands/ps.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+# --- Process management ---
+register "ps:restart", "Restart app (usage: wokku ps:restart APP)" do
+  id = ARGV.shift || abort("Usage: wokku ps:restart APP")
+  api(:post, "/apps/#{id}/restart")
+  Wokku::Output.status "Restarting..."
+end
+
+register "ps:stop", "Stop app (usage: wokku ps:stop APP)" do
+  id = ARGV.shift || abort("Usage: wokku ps:stop APP")
+  api(:post, "/apps/#{id}/stop")
+  Wokku::Output.status "Stopped."
+end
+
+register "ps:start", "Start app (usage: wokku ps:start APP)" do
+  id = ARGV.shift || abort("Usage: wokku ps:start APP")
+  api(:post, "/apps/#{id}/start")
+  Wokku::Output.status "Started."
+end
+
+register "ps:rebuild", "Rebuild + redeploy app (usage: wokku ps:rebuild APP)" do
+  id = ARGV.shift || abort("Usage: wokku ps:rebuild APP")
+  data = api(:post, "/apps/#{id}/deploy")
+  Wokku::Output.status "Rebuild triggered. Deploy ##{data['deploy_id']} (release ##{data['release_id']})."
+  Wokku::Output.status "Tail logs with: wokku logs #{id} --lines 200"
+end
+
+register "redeploy", "Redeploy app from latest source (usage: wokku redeploy APP)" do
+  id = ARGV.shift || abort("Usage: wokku redeploy APP")
+  data = api(:post, "/apps/#{id}/deploy")
+  Wokku::Output.status "Redeploy triggered. Deploy ##{data['deploy_id']} (release ##{data['release_id']})."
+end
+
+register "ps:scale", "Scale processes (usage: wokku ps:scale APP web=2 worker=1)" do
+  id = ARGV.shift || abort("Usage: wokku ps:scale APP web=N worker=N")
+  scaling = {}
+  ARGV.each do |pair|
+    type, count = pair.split("=")
+    scaling[type] = count.to_i if type && count
+  end
+  ARGV.clear
+  abort "No scaling pairs given. Example: web=2 worker=1" if scaling.empty?
+  api(:patch, "/apps/#{id}/ps", { scaling: scaling })
+  Wokku::Output.status "Scaled: #{scaling.map { |t, c| "#{t}=#{c}" }.join(' ')}"
+end

data/lib/wokku/commands/releases.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+# --- Releases ---
+register "releases", "List releases (usage: wokku releases APP)" do
+  id = ARGV.shift || abort("Usage: wokku releases APP")
+  data = api(:get, "/apps/#{id}/releases")
+  Wokku::Output.render(data) do |d|
+    if d.is_a?(Array)
+      table(d.map { |r| { "version" => "v#{r['version']}", "description" => r["description"].to_s[0..40], "created" => r["created_at"].to_s[0..18] } })
+    else
+      puts_json d
+    end
+  end
+end
+
+register "rollback", "Rollback to release (usage: wokku rollback APP RELEASE_ID)" do
+  id = ARGV.shift || abort("Usage: wokku rollback APP RELEASE_ID")
+  release_id = ARGV.shift || abort("Missing release ID")
+  api(:post, "/apps/#{id}/releases/#{release_id}/rollback")
+  Wokku::Output.status "Rolling back..."
+end

data/lib/wokku/commands/run.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# --- One-off command in an ephemeral container ---
+register "run", "Run a one-off command (usage: wokku run APP -- COMMAND [ARGS...])" do
+  id = ARGV.shift || abort("Usage: wokku run APP -- COMMAND")
+  ARGV.shift if ARGV.first == "--"
+  cmd = ARGV.join(" ")
+  ARGV.clear
+  abort "Missing command. Example: wokku run APP -- bin/rails console" if cmd.strip.empty?
+  data = api(:post, "/apps/#{id}/run", { command: cmd })
+  puts data["output"] if data.is_a?(Hash) && data["output"]
+  exit (data["exit_code"] || 0).to_i if data.is_a?(Hash) && data.key?("exit_code")
+end

data/lib/wokku/commands/servers.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+# --- Servers ---
+register "servers", "List available servers" do
+  data = api(:get, "/servers")
+  default_name = Wokku::Config.load["default_server"]
+  Wokku::Output.render(data) do |list|
+    table(list.map { |s| {
+      "name" => s["name"], "host" => s["host"], "status" => s["status"],
+      "default" => s["name"] == default_name ? "*" : ""
+    } })
+  end
+end
+
+register "servers:info", "Show server details (usage: wokku servers:info SERVER)" do
+  name = ARGV.shift || abort("Usage: wokku servers:info SERVER")
+  data = api(:get, "/servers/#{name}")
+  Wokku::Output.render(data) { |d| puts_json d }
+end
+
+register "servers:default", "Set the default server (usage: wokku servers:default SERVER | --clear)" do
+  arg = ARGV.shift || abort("Usage: wokku servers:default SERVER | --clear")
+  cfg = Wokku::Config.load
+  if arg == "--clear"
+    cfg.delete("default_server")
+    Wokku::Config.save(cfg)
+    Wokku::Output.status "Default server cleared."
+  else
+    api(:get, "/servers/#{arg}")  # validates server exists; aborts on 404
+    cfg["default_server"] = arg
+    Wokku::Config.save(cfg)
+    Wokku::Output.status "Default server set to: #{arg}"
+  end
+end

data/lib/wokku/commands/ssh_keys.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+# --- SSH keys ---
+register "ssh-keys", "List your SSH public keys" do
+  data = api(:get, "/ssh_keys")
+  Wokku::Output.render(data) do |list|
+    table(list.map { |k| {
+      "name" => k["name"],
+      "fingerprint" => "#{k['fingerprint'].to_s[0..30]}...",
+      "created" => k["created_at"].to_s[0..18]
+    } })
+  end
+end
+
+register "ssh-keys:add", "Upload an SSH public key (usage: wokku ssh-keys:add [PATH] --name LABEL)" do
+  path = nil
+  name = nil
+  while arg = ARGV.shift
+    case arg
+    when "--name" then name = ARGV.shift
+    else path ||= arg
+    end
+  end
+  path ||= File.expand_path("~/.ssh/id_ed25519.pub")
+  abort "Public key not found at #{path}. Pass an explicit path." unless File.exist?(path)
+  abort "Missing --name LABEL" unless name
+
+  public_key = File.read(path).strip
+  data = api(:post, "/ssh_keys", { name: name, public_key: public_key })
+  Wokku::Output.status "Added SSH key '#{data['name']}' (#{data['fingerprint'][0..20]}...)"
+end
+
+register "ssh-keys:remove", "Remove an SSH public key (usage: wokku ssh-keys:remove NAME | --fingerprint SHA — fingerprint takes precedence)" do
+  name = nil
+  fingerprint = nil
+  while arg = ARGV.shift
+    case arg
+    when "--fingerprint" then fingerprint = ARGV.shift
+    else name ||= arg
+    end
+  end
+  abort "Usage: wokku ssh-keys:remove NAME [--fingerprint SHA]" unless name || fingerprint
+
+  list = api(:get, "/ssh_keys")
+  match = if fingerprint
+    list.find { |k| k["fingerprint"] == fingerprint }
+  else
+    by_name = list.select { |k| k["name"] == name }
+    abort "No SSH key named '#{name}'" if by_name.empty?
+    abort "Multiple keys named '#{name}' — pass --fingerprint to disambiguate." if by_name.size > 1
+    by_name.first
+  end
+  abort "SSH key not found" unless match
+
+  api(:delete, "/ssh_keys/#{match['id']}")
+  Wokku::Output.status "Removed SSH key '#{match['name']}'"
+end

data/lib/wokku/commands/storage.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+# --- Storage (host-bind volumes) ---
+register "storage", "List storage mounts (usage: wokku storage APP)" do
+  id = ARGV.shift || abort("Usage: wokku storage APP")
+  data = api(:get, "/apps/#{id}/storage")
+  Wokku::Output.render(data) do |d|
+    list = d.is_a?(Hash) ? Array(d["mounts"]) : Array(d)
+    if list.empty?
+      puts "(no mounts configured)"
+    else
+      list.each { |m| puts m }
+    end
+  end
+end
+
+register "storage:mount", "Add a host-bind mount (usage: wokku storage:mount APP HOST_PATH:CONTAINER_PATH)" do
+  id = ARGV.shift || abort("Usage: wokku storage:mount APP HOST_PATH:CONTAINER_PATH")
+  spec = ARGV.shift || abort("Missing HOST_PATH:CONTAINER_PATH")
+  abort "Mount must be HOST_PATH:CONTAINER_PATH" unless spec.include?(":")
+  api(:post, "/apps/#{id}/storage", { mount: spec })
+  Wokku::Output.status "Mounted: #{spec}"
+  Wokku::Output.status "Restart the app to pick up the mount: wokku ps:restart #{id}"
+end
+
+register "storage:unmount", "Remove a host-bind mount (usage: wokku storage:unmount APP HOST_PATH:CONTAINER_PATH)" do
+  id = ARGV.shift || abort("Usage: wokku storage:unmount APP HOST_PATH:CONTAINER_PATH")
+  spec = ARGV.shift || abort("Missing HOST_PATH:CONTAINER_PATH")
+  api(:delete, "/apps/#{id}/storage", { mount: spec })
+  Wokku::Output.status "Unmounted: #{spec}"
+end

data/lib/wokku/commands/templates.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+# --- Templates ---
+register "templates", "List available templates" do
+  data = api(:get, "/templates")
+  Wokku::Output.render(data) do |d|
+    if d.is_a?(Array)
+      d.each { |t| puts "#{t['slug'] || t['name']}  #{t['description'].to_s[0..60]}" }
+    else
+      puts_json d
+    end
+  end
+end
+
+register "deploy", "Deploy template (usage: wokku deploy TEMPLATE [--server SERVER] [--name NAME])" do
+  slug = ARGV.shift || abort("Usage: wokku deploy TEMPLATE_SLUG [--server SERVER]")
+  server = nil
+  name = nil
+  while arg = ARGV.shift
+    case arg
+    when "--server" then server = ARGV.shift
+    when "--name" then name = ARGV.shift
+    end
+  end
+  server = resolve_server(explicit: server)
+  body = { slug: slug, server_id: server }
+  body[:name] = name if name
+  data = api(:post, "/templates/deploy", body)
+  Wokku::Output.status "Deploying #{slug}..."
+  Wokku::Output.render(data) { |d| puts_json d }
+end

data/lib/wokku/commands/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+register "version", "Show CLI version" do
+  Wokku::Output.render({ "version" => VERSION }) { |d| puts "wokku/#{d['version']}" }
+end

data/lib/wokku/config.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "json"
+
+module Wokku
+  module Config
+    DEFAULT_DIR = File.expand_path("~/.wokku")
+
+    module_function
+
+    def dir
+      ENV["WOKKU_CONFIG_DIR"] || DEFAULT_DIR
+    end
+
+    def file
+      File.join(dir, "config.json")
+    end
+
+    def load
+      return {} unless File.exist?(file)
+      JSON.parse(File.read(file))
+    rescue StandardError
+      {}
+    end
+
+    def save(data)
+      FileUtils.mkdir_p(dir)
+      File.write(file, JSON.pretty_generate(data))
+      File.chmod(0600, file)
+    end
+
+    def api_url
+      load["api_url"] || ENV["WOKKU_API_URL"] || "https://wokku.cloud/api/v1"
+    end
+
+    def api_token
+      load["token"] || ENV["WOKKU_API_TOKEN"]
+    end
+  end
+end

data/lib/wokku/helpers.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+# Cross-command helpers. Defined as top-level methods (matching the
+# api/table/puts_json pattern) so command blocks can call them without
+# a namespace prefix. Loaded by cli/wokku at boot.
+
+# Look up a domain row by hostname so users can pass the name they know
+# rather than an internal id. Returns nil when not found or when the API
+# returns a non-array (error envelope).
+def find_domain(app_id, hostname)
+  list = api(:get, "/apps/#{app_id}/domains")
+  return nil unless list.is_a?(Array)
+  list.find { |d| d["hostname"] == hostname }
+end
+
+# Resolve which server to target for a deploy/create. Walks the
+# precedence chain: explicit flag → env → config → auto-pick if
+# only one server → abort with helpful error. Returns the server
+# name or UUID (whatever was explicitly passed/configured).
+def resolve_server(explicit: nil)
+  return explicit if explicit
+  env = ENV["WOKKU_DEFAULT_SERVER"]
+  return env if env && !env.empty?
+  cfg_default = Wokku::Config.load["default_server"]
+  return cfg_default if cfg_default
+
+  servers = api(:get, "/servers")
+  unless servers.is_a?(Array)
+    abort "Unexpected response from /servers: #{servers.inspect[0..200]}"
+  end
+  abort "No servers available. Contact wokku.cloud support." if servers.empty?
+  return servers.first["name"] if servers.size == 1
+
+  names = servers.map { |s| s["name"] }.join(", ")
+  abort "Multiple servers available (#{names}). Pass --server NAME or set a default: wokku servers:default NAME"
+end

data/lib/wokku/output.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Wokku
+  module Output
+    module_function
+
+    def table(rows, headers: nil)
+      return if rows.empty?
+      cols = (headers || rows.first.keys).map(&:to_s)
+      widths = cols.map(&:length)
+      rows.each { |r| cols.each_with_index { |c, i| widths[i] = [widths[i], r[c].to_s.length].max } }
+
+      fmt = widths.map { |w| "%-#{w}s" }.join("  ")
+      puts fmt % cols.map(&:upcase)
+      puts widths.map { |w| "-" * w }.join("  ")
+      rows.each { |r| puts fmt % cols.map { |c| r[c] } }
+    end
+
+    def puts_json(data)
+      puts JSON.pretty_generate(data)
+    end
+
+    # Smart printer for read commands: prints raw API response as JSON when
+    # the global --json flag is set; otherwise yields to the human formatter.
+    def render(data)
+      if Wokku.json?
+        puts JSON.pretty_generate(data)
+      else
+        yield data
+      end
+    end
+
+    # Suppressible status / hint message. Silenced by --quiet or --json.
+    # Errors should NOT use this — they go through `abort` which writes to
+    # stderr and is never silenced.
+    def status(message)
+      return if Wokku.quiet? || Wokku.json?
+      puts message
+    end
+  end
+end

data/lib/wokku/registry.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Wokku
+  module Registry
+    COMMANDS = {}
+
+    module_function
+
+    def register(name, desc, &block)
+      COMMANDS[name] = { desc: desc, handler: block }
+    end
+  end
+end

data/lib/wokku/version.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+module Wokku
+  VERSION = "0.1.0"
+end

data/lib/wokku.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+require "json"
+require "net/http"
+require "uri"
+require "io/console"
+require "fileutils"
+
+require "wokku/version"
+require "wokku/config"
+require "wokku/output"
+require "wokku/api_client"
+require "wokku/registry"
+require "wokku/helpers"
+
+module Wokku
+  class << self
+    attr_writer :api_client
+    attr_accessor :json, :quiet
+
+    def api_client
+      @api_client ||= ApiClient.new(user_agent: "WokkuCLI/#{VERSION}")
+    end
+
+    def json?  = !!@json
+    def quiet? = !!@quiet
+  end
+
+  module CLI
+    COMMANDS = Wokku::Registry::COMMANDS
+
+    module_function
+
+    def dispatch(args)
+      sep = args.index("--")
+      head = sep ? args[0...sep] : args.dup
+      tail = sep ? args[sep..] : []
+      Wokku.json  = !!head.delete("--json")
+      Wokku.quiet = !!(head.delete("--quiet") || head.delete("-q"))
+      ARGV.replace(head + tail)
+      command = ARGV.shift
+
+      if command.nil? || command == "help" || command == "--help" || command == "-h"
+        show_help
+        return 0
+      elsif COMMANDS[command]
+        COMMANDS[command][:handler].call
+        return 0
+      else
+        puts "Unknown command: #{command}"
+        puts "Run 'wokku help' for available commands."
+        return 1
+      end
+    end
+
+    def show_help
+      puts "Wokku CLI v#{Wokku::VERSION}"
+      puts "Usage: wokku COMMAND [args] [--json] [--quiet]"
+      puts
+      puts "Commands:"
+      COMMANDS.sort_by { |k, _| k }.each do |name, cmd|
+        puts "  %-20s %s" % [name, cmd[:desc]]
+      end
+      puts
+      puts "Global flags:"
+      puts "  --json    Machine-readable JSON output (read commands only)"
+      puts "  --quiet   Suppress success messages and hints (alias: -q)"
+      puts
+      puts "Run 'wokku auth:login' to get started."
+    end
+  end
+end
+
+# Top-level helper shims used by command blocks (preserved for compatibility
+# with the existing register-DSL pattern).
+def api(method, path, body = nil)
+  Wokku.api_client.request(method, path, body)
+rescue Wokku::ApiClient::NotAuthenticated, Wokku::ApiClient::Timeout,
+       Wokku::ApiClient::Unreachable, Wokku::ApiClient::Error => e
+  abort e.message
+end
+
+def load_config = Wokku::Config.load
+def save_config(data) = Wokku::Config.save(data)
+def api_url = Wokku::Config.api_url
+def api_token = Wokku::Config.api_token
+def table(rows, headers: nil) = Wokku::Output.table(rows, headers: headers)
+def puts_json(data) = Wokku::Output.puts_json(data)
+def register(name, desc, &block) = Wokku::Registry.register(name, desc, &block)
+
+CONFIG_DIR  = Wokku::Config::DEFAULT_DIR
+CONFIG_FILE = File.join(CONFIG_DIR, "config.json")
+VERSION     = Wokku::VERSION
+
+# Load all command files (they register via the top-level `register` shim).
+Dir[File.expand_path("wokku/commands/*.rb", __dir__)].sort.each { |f| require f }

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification
+name: wokku-cli
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Johannes Dwicahyo
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: Deploy and manage apps, databases, domains, and SSH keys on Wokku.cloud
+  or self-hosted Wokku servers.
+email:
+- johannesdwicahyo@gmail.com
+executables:
+- wokku
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- exe/wokku
+- lib/wokku.rb
+- lib/wokku/api_client.rb
+- lib/wokku/commands/activity.rb
+- lib/wokku/commands/addons.rb
+- lib/wokku/commands/apps.rb
+- lib/wokku/commands/auth.rb
+- lib/wokku/commands/buildpacks.rb
+- lib/wokku/commands/certs.rb
+- lib/wokku/commands/checks.rb
+- lib/wokku/commands/config.rb
+- lib/wokku/commands/databases.rb
+- lib/wokku/commands/do.rb
+- lib/wokku/commands/domains.rb
+- lib/wokku/commands/logs.rb
+- lib/wokku/commands/ps.rb
+- lib/wokku/commands/releases.rb
+- lib/wokku/commands/run.rb
+- lib/wokku/commands/servers.rb
+- lib/wokku/commands/ssh_keys.rb
+- lib/wokku/commands/storage.rb
+- lib/wokku/commands/templates.rb
+- lib/wokku/commands/version.rb
+- lib/wokku/config.rb
+- lib/wokku/helpers.rb
+- lib/wokku/output.rb
+- lib/wokku/registry.rb
+- lib/wokku/version.rb
+homepage: https://wokku.cloud
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://wokku.cloud
+  source_code_uri: https://github.com/johannesdwicahyo/wokku-cli
+  bug_tracker_uri: https://github.com/johannesdwicahyo/wokku-cli/issues
+  changelog_uri: https://github.com/johannesdwicahyo/wokku-cli/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Wokku CLI — manage your Wokku apps from the terminal
+test_files: []