wokku-cli 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 90dbd93905c3fc3dc7422cf4342def249b9ff04d3c5bbefd64f5d4a5ccc23cb6
-  data.tar.gz: 01b1043ff82e7ae509ddb36eed9fa6d9657b7321ae82502996c448eb4d755440
+  metadata.gz: 820e03562fff67b93f087227eb2da57e79e761c43ac5c108680699ce068a480e
+  data.tar.gz: '077218e9886faadb334a615e225a3f61802688f29f6e9ac53625ca4f505f632d'
 SHA512:
-  metadata.gz: 7650db80c9d0608c8f879c86f556008ae47af5cd3827e029378e7327e455b9762ef6f4260a73f0d1da61c7c8a93b2bdfe03fd01fae1ca3212e60acbbfa61bc56
-  data.tar.gz: 33fbc61d1092de38e30737cedcb83750bc55fa8193f1cf3604599e5ecf7e6103bc16faa7775c8bab0217d44dc3ba2b33cae6804c921007888f9097c277e94f78
+  metadata.gz: 9518d6c33f111278305093a0d55f925772fe3363f4abe95df3d32b83e105d03f3e0bd2001add8f696c717d5e89352926fec2c1220fe7cb74baebc523a8c6812d
+  data.tar.gz: 1326795840aae9837bb480a821e466ce8c64e90a0fc5ed2f01c8929b7adb16da27760aa7d3c459fc65cf60afd18ac5de006be0e790d639af8eb6e09296ae9dcd

data/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 0.4.0 — 2026-06-01
+
+MCP commands — wire the wokku-plugin Claude Code MCP server with one command. Pairs with wokku-cloud canonical backlog 1.3.
+
+### Added
+
+- `wokku mcp:install` — registers the Wokku MCP server in Claude Code using the active CLI token + API URL.
+- `wokku mcp:switch` — re-pushes the current CLI token to the MCP config (after `auth:login` swapped accounts).
+- `wokku mcp:logout` — removes the Wokku MCP server from Claude Code.
+
+Shells out to `claude mcp add / remove` so we don't depend on Claude Code's internal config-file layout (it changes between versions). Aborts with a clear "install Claude Code first" error if the `claude` CLI isn't on PATH.
+
+## 0.3.0 — 2026-05-31
+
+Bundle v2 — boxes, shared addons (user-pick per box), and dedicated upgrades for PostgreSQL / MySQL / MongoDB / Redis. Pairs with wokku-cloud Phase 7 prep PRs #67–#73.
+
+### Added
+- `apps:create` gains `--box-size SIZE` (sleeping/small/medium/large/xlarge), `--shared pg,redis,...` (comma-separated shared engines to attach), `--dedicated-db postgres|mysql|mongodb`, `--dedicated-redis`. All optional — omitting them keeps the old free-tier default.
+- `addons:shared:enable APP ENGINE` — attach a shared engine (Pg/Redis/Memcached/RabbitMQ/Meilisearch). Free plan limited to Pg+Redis.
+- `addons:shared:disable APP ENGINE` — detach a shared engine + destroy its tenant data.
+- `addons:dedicated:upgrade APP ENGINE` — upgrade to a dedicated container. Pg/Redis migrate from shared (data preserved). MySQL/MongoDB are fresh-create. Quota: 3 per plan; size follows the box size.
+- `addons` listing now shows `kind: shared|dedicated` per row.
+
+### Deprecated
+- `addons:add` — kept for back-compat with wokku-cloud servers that haven't flipped `BUNDLE_V2_ENABLED=true` yet. When the server has bundle v2 on, this endpoint returns 410 Gone with guidance to use the new commands above.
+
+### Requires
+- wokku-cloud server-side support shipped 2026-05-31 (Phase 7 prep PRs #67–#73).
+
 ## 0.2.0 — 2026-05-06
 
 Interactive shell over WebSocket: open a real PTY in your app's container, exec one-off commands, and connect to managed databases without leaving the terminal.

data/README.md

@@ -1,6 +1,8 @@
 # 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.
+CLI for [Wokku Cloud](https://wokku.cloud) — deploy and manage apps, databases, domains, and SSH keys.
+
+> **Wokku Cloud only.** This CLI talks to the Wokku REST API, which ships only with the managed Wokku Cloud product. The open-source Wokku web UI ([github.com/johannesdwicahyo/wokku](https://github.com/johannesdwicahyo/wokku)) does not expose `/api/v1`, so the CLI cannot point at a self-hosted Wokku install. Self-host users should use the web UI directly, or `ssh dokku@your-host` for command-line operations.
 
 ## Install
 
@@ -26,22 +28,47 @@ wokku logs myapp -f
 
 ## Commands
 
-Run `wokku --help` for the full list. Highlights:
+Run `wokku --help` for the full list. ~39 first-class commands today, grouped:
 
-- **Apps:** `apps`, `apps:create`, `apps:destroy`, `apps:info`
-- **Process:** `ps:start/stop/restart/scale/rebuild`, `redeploy`
+- **Apps:** `apps`, `apps:create`, `apps:destroy`, `apps:info`, `apps:transfer`
+- **Process:** `ps`, `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`
+- **Domains + SSL:** `domains`, `domains:add/remove/clear`, `certs:enable`, `certs:disable`
+- **Databases:** `databases`, `databases:create/destroy/link/unlink/info`, `backups`, `backups:create/restore`
 - **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`
+- **Servers:** `servers`, `servers:info`, `servers:default` (multi-Dokku-host installs)
+- **Teams:** `teams`, `teams:members`, `teams:invite`, `teams:remove`
+- **Logs:** `wokku logs APP --follow [--tail N]`
+- **Run / passthrough:** `wokku run APP -- COMMAND` (one-off in a fresh container), `wokku do APP -- DOKKU_ARGS` (arbitrary `dokku` CLI passthrough)
+
+### Parity with Dokku
+
+`wokku do` is the bridge for the ~110 Dokku subcommands not yet first-classed here. Anything `dokku <something> APP` does, `wokku do APP -- <something>` does too — same exit code, same stdout.
+
+If you find yourself running the same `wokku do` invocation repeatedly, open an issue — that's the queue for promoting commands to first-class status.
 
 ## Global flags
 
-- `--json` — machine-readable JSON output (read commands)
+- `--json` — machine-readable JSON output (read commands only)
 - `--quiet` / `-q` — suppress success messages and hints
+- `--server NAME` — target a specific Dokku host on multi-server installs (default: your account's primary)
+
+## Configuration
+
+Set once and forget:
+
+```sh
+export WOKKU_API_TOKEN=...   # from wokku.cloud/dashboard/profile
+```
+
+`WOKKU_API_URL` defaults to `https://wokku.cloud/api/v1` and shouldn't need to change.
+
+## What's New in v0.2.0 (May 2026)
+
+- `apps:transfer` for moving an app between teams
+- `--quiet` flag now also suppresses progress bars (not just success lines) — friendlier in scripts
+- `wokku do` exit codes pass through correctly when wrapped in pipelines (was previously masked to 0)
+- Multi-server defaults — `wokku servers:default` persists per-account, not per-shell
 
 ## License
 

data/lib/wokku/commands/addons.rb

@@ -6,18 +6,25 @@ register "addons", "List add-ons (usage: wokku addons APP)" do
   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"] } })
+      table(d.map { |a|
+        {
+          "name"   => a["name"],
+          "type"   => a["service_type"],
+          "kind"   => a["shared"] ? "shared" : "dedicated",
+          "status" => a["status"]
+        }
+      })
     else
       puts_json d
     end
   end
 end
 
-register "addons:add", "Add add-on (usage: wokku addons:add APP postgres)" do
+register "addons:add", "[LEGACY pre-Bundle-v2] Add add-on (usage: wokku addons:add APP postgres). Returns 410 under Bundle v2 — use addons:shared:enable or addons:dedicated:upgrade instead." 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
+  while (arg = ARGV.shift)
     name = ARGV.shift if arg == "--name"
   end
   body = { service_type: service_type }
@@ -25,3 +32,31 @@ register "addons:add", "Add add-on (usage: wokku addons:add APP postgres)" do
   data = api(:post, "/apps/#{id}/addons", body)
   Wokku::Output.status "Added #{service_type}: #{data['name'] || data['id']}"
 end
+
+# --- Bundle v2 — shared engines ---
+# User-pick at box creation OR via these commands later. Free plan limited
+# to postgres + redis; other plans get all 5 (memcached, rabbitmq, meilisearch
+# also available).
+register "addons:shared:enable", "Enable a shared engine on an app (usage: wokku addons:shared:enable APP ENGINE). ENGINE: postgres|redis|memcached|rabbitmq|meilisearch" do
+  id     = ARGV.shift || abort("Usage: wokku addons:shared:enable APP ENGINE")
+  engine = ARGV.shift || abort("Missing engine")
+  data   = api(:post, "/apps/#{id}/addons/shared", { engine: engine })
+  Wokku::Output.status(data["message"] || "Enabled shared #{engine} on #{id}")
+end
+
+register "addons:shared:disable", "Disable a shared engine on an app (usage: wokku addons:shared:disable APP ENGINE)" do
+  id     = ARGV.shift || abort("Usage: wokku addons:shared:disable APP ENGINE")
+  engine = ARGV.shift || abort("Missing engine")
+  data   = api(:delete, "/apps/#{id}/addons/shared/#{engine}")
+  Wokku::Output.status(data["message"] || "Disabled shared #{engine} on #{id}")
+end
+
+# --- Bundle v2 — dedicated upgrade ---
+# Pg/Redis migrate from shared (existing data preserved). MySQL/MongoDB
+# are fresh-create. Quota: 3 per plan, size follows the box size.
+register "addons:dedicated:upgrade", "Upgrade a box to a dedicated DB or Redis (usage: wokku addons:dedicated:upgrade APP ENGINE). ENGINE: postgres|mysql|mongodb|redis" do
+  id     = ARGV.shift || abort("Usage: wokku addons:dedicated:upgrade APP ENGINE")
+  engine = ARGV.shift || abort("Missing engine (postgres|mysql|mongodb|redis)")
+  data   = api(:post, "/apps/#{id}/addons/dedicated", { engine: engine })
+  Wokku::Output.status(data["message"] || "Dedicated #{engine} upgrade queued for #{id}")
+end

data/lib/wokku/commands/apps.rb

@@ -14,19 +14,33 @@ register "apps:info", "Show app details (usage: wokku apps:info APP)" do
   Wokku::Output.render(data) { |d| puts_json d }
 end
 
-register "apps:create", "Create app (usage: wokku apps:create NAME [--server SERVER] [--branch BRANCH])" do
+register "apps:create", "Create app (usage: wokku apps:create NAME [--server SERVER] [--branch BRANCH] [--box-size SIZE] [--shared pg,redis,...] [--dedicated-db postgres|mysql|mongodb] [--dedicated-redis])" do
   name = ARGV.shift || abort("Usage: wokku apps:create NAME [--server SERVER]")
   server = nil
   branch = "main"
-  while arg = ARGV.shift
+  box_size = nil
+  shared = nil
+  dedicated_db = nil
+  dedicated_redis = false
+  while (arg = ARGV.shift)
     case arg
-    when "--server" then server = ARGV.shift
-    when "--branch" then branch = ARGV.shift
+    when "--server"           then server = ARGV.shift
+    when "--branch"           then branch = ARGV.shift
+    when "--box-size"         then box_size = ARGV.shift
+    when "--shared"           then shared = ARGV.shift  # comma-separated engine names
+    when "--dedicated-db"     then dedicated_db = ARGV.shift
+    when "--dedicated-redis"  then dedicated_redis = true
     end
   end
   server = resolve_server(explicit: server)
-  data = api(:post, "/apps", { name: name, server_id: server, deploy_branch: branch })
+  body = { name: name, server_id: server, deploy_branch: branch }
+  body[:box_size] = box_size if box_size
+  body[:enabled_shared_engines] = shared.split(",").map(&:strip) if shared
+  body[:dedicated_db_engine] = dedicated_db if dedicated_db
+  body[:add_dedicated_redis] = true if dedicated_redis
+  data = api(:post, "/apps", body)
   Wokku::Output.status "Created app: #{data['name']} (id: #{data['id']})"
+  Array(data["warnings"]).each { |w| Wokku::Output.warn(w) }
 end
 
 register "apps:destroy", "Delete app (usage: wokku apps:destroy APP)" do

data/lib/wokku/commands/mcp.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+# Wokku MCP commands — install / switch / logout the Wokku MCP server
+# in Claude Code so the user's CLI token gets passed to the plugin.
+# Shells out to `claude mcp` (Claude Code CLI) so we don't need to know
+# Claude Code's exact config-file layout — it changes between versions.
+
+MCP_SERVER_NAME = "wokku"
+
+def claude_cli_available?
+  system("command -v claude >/dev/null 2>&1")
+end
+
+def require_claude_cli!
+  return if claude_cli_available?
+  abort <<~MSG
+    The `claude` CLI is not installed.
+    Wokku MCP commands shell out to it to write your Claude Code config.
+
+    Install Claude Code (https://claude.com/claude-code) and retry.
+  MSG
+end
+
+def require_logged_in!
+  return if Wokku::Config.api_token
+  abort "Not logged in. Run: wokku auth:login"
+end
+
+def install_mcp_entry!
+  url   = Wokku::Config.api_url
+  token = Wokku::Config.api_token
+
+  # Idempotent — silently no-ops if the entry doesn't exist yet.
+  system("claude mcp remove #{Shellwords.escape(MCP_SERVER_NAME)} > /dev/null 2>&1")
+
+  ok = system(
+    "claude", "mcp", "add", MCP_SERVER_NAME,
+    "--env", "WOKKU_API_URL=#{url}",
+    "--env", "WOKKU_API_TOKEN=#{token}",
+    "--", "npx", "-y", "@johannesdwicahyo/wokku-plugin"
+  )
+  ok or abort "claude mcp add failed — check `claude mcp list` and retry."
+end
+
+register "mcp:install", "Add the Wokku MCP server to Claude Code with your CLI token" do
+  require_claude_cli!
+  require_logged_in!
+  require "shellwords"
+
+  install_mcp_entry!
+  Wokku::Output.status "MCP server '#{MCP_SERVER_NAME}' installed in Claude Code."
+  Wokku::Output.status "Restart Claude Code, then ask: \"Deploy this project to Wokku\""
+end
+
+register "mcp:switch", "Re-push the current CLI token to the Wokku MCP server (after auth:login)" do
+  require_claude_cli!
+  require_logged_in!
+  require "shellwords"
+
+  install_mcp_entry!
+  Wokku::Output.status "MCP server '#{MCP_SERVER_NAME}' now points at the current CLI session."
+  Wokku::Output.status "Restart Claude Code for the new token to take effect."
+end
+
+register "mcp:logout", "Remove the Wokku MCP server from Claude Code" do
+  require_claude_cli!
+  require "shellwords"
+
+  ok = system("claude", "mcp", "remove", MCP_SERVER_NAME)
+  if ok
+    Wokku::Output.status "MCP server '#{MCP_SERVER_NAME}' removed from Claude Code."
+  else
+    Wokku::Output.status "No MCP entry named '#{MCP_SERVER_NAME}' to remove."
+  end
+end

data/lib/wokku/output.rb

@@ -39,5 +39,14 @@ module Wokku
       return if Wokku.quiet? || Wokku.json?
       puts message
     end
+
+    # Non-fatal warning (e.g. partial-success cases like "app created
+    # but the dedicated DB upgrade failed to enqueue"). Stderr so it
+    # doesn't pollute pipeable stdout; visible even with --quiet but
+    # silenced under --json (the JSON response carries the warning).
+    def warn(message)
+      return if Wokku.json?
+      $stderr.puts "WARNING: #{message}"
+    end
   end
 end

data/lib/wokku/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wokku-cli
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Johannes Dwicahyo
@@ -52,6 +52,7 @@ files:
 - lib/wokku/commands/do.rb
 - lib/wokku/commands/domains.rb
 - lib/wokku/commands/logs.rb
+- lib/wokku/commands/mcp.rb
 - lib/wokku/commands/ps.rb
 - lib/wokku/commands/releases.rb
 - lib/wokku/commands/run.rb