iterm2_ruby 0.2.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e7e477efa0c27e00e1cb34267975a48402332821b9ae336c55425ad3733e0bab
-  data.tar.gz: fbb8e0de6adce1dcf2fdca490c36bde11f1b652755d49d2520d18d33468b5be1
+  metadata.gz: 7ea8b3aab793d0294a0cb9f726e8cc01123b0da6a22b02034a7f64c3e4744959
+  data.tar.gz: 3773d06e8c6969221bb52049ff3a11131a786f8280d36e3f5a889174c3a56d17
 SHA512:
-  metadata.gz: 9ce8e36e0bc21000133f8d6fa0cc037aed5902812a298e5732e7865452a7f7b10fe1917882cf94d861bf55be6d83dc1bb39dce826d0bbf50d6f194b768fbe1f6
-  data.tar.gz: b2bbc939e3c51138ff675655f2a9ba421fdba58ae0e2250c64640d91f5096315c3ef0f9283f07b53269fe5c9d555f587e9b16203d26df469f620756cd792fbd2
+  metadata.gz: ecff09efcb6229d0079eff7f8cc324fb0da17287c762f39fb1e99ada8c2476283373ed6ef48c097c3c36f6fe87346485c3b311133f0ca45be22e5f60940da729
+  data.tar.gz: 143e8af32d29624720bb35719eb399e620364c0e632bc5613ea710190acd0c8a5b8c3112a150db5794ff8da1968a6c39d38d1288626366ee9231ddf9810c63f5

data/CHANGELOG.md

@@ -3,6 +3,25 @@
 All notable changes to this project are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.3.1] - 2026-09-04
+
+### Fixed
+- `client.get_window_frame(window_id)` restored under its documented name. A local
+  amend of the 0.3.0 commit (made before publish, after this method had already been
+  verified) silently renamed it to `client.window_frame`; the published 0.3.0 gem on
+  rubygems only exposes `window_frame` and lacks `get_window_frame`. Source is fixed
+  here; the published artifact is fixed by the next release.
+
+## [0.3.0] - 2026-09-03
+
+### Added
+- `client.set_property`/`get_property` counterpart -- `client.set_property(name, value, session_id:, window_id:)`
+- `client.window_frame(window_id)` / `client.set_window_frame(window_id, x:, y:, width:, height:)` --
+  windows created via `create_tab`/`split_pane` open at the profile's default size regardless of content;
+  this is the only way to move/resize one afterward.
+- `client.set_session_grid_size(session_id, columns:, rows:)` -- resize a session's character grid
+- CLI: `set-window-frame WINDOW_ID X Y WIDTH HEIGHT`, `get-window-frame WINDOW_ID [--json]`
+
 ## [0.2.0] - 2026-07-02
 
 ### Added

data/README.md

@@ -156,6 +156,8 @@ end
 | `raise --cwd PATH` | Raise tab by working directory |
 | `activate-session ID` | Activate a session directly by ID |
 | `create [window\|tab]` | Create a new window or tab |
+| `set-window-frame ID X Y W H` | Move/resize a window (pixels) |
+| `get-window-frame ID` | Read a window's frame (pixels) |
 | `split` | Split the current pane |
 | `close` | Close a session |
 | `move --tab ID --to-window ID` | Move a tab to another window |
@@ -215,6 +217,9 @@ Most commands accept `--session ID`, `--tab ID`, or `--window ID` to target a sp
 | `close_session(session_id)` | Close a session |
 | `close_tab(tab_id)` | Close a tab |
 | `reorder_tabs(window_id => [tab_ids])` | Move/reorder tabs across windows |
+| `window_frame(window_id)` | Get a window's frame (position + size, pixels) |
+| `set_window_frame(window_id, x:, y:, width:, height:)` | Move/resize a window (pixels) |
+| `set_session_grid_size(session_id, columns:, rows:)` | Set a session's grid size (columns/rows) |
 
 ### Profile & Properties
 
@@ -224,6 +229,7 @@ Most commands accept `--session ID`, `--tab ID`, or `--window ID` to target a sp
 | `get_profile_property(session_id, *keys)` | Get profile properties |
 | `list_profiles(properties:, guids:)` | List all profiles |
 | `get_property(name, session_id:)` | Get a session/window property |
+| `set_property(name, value, session_id:)` | Set a session/window property |
 | `get_variables(*names, session_id:)` | Get variables |
 | `set_variables(vars, session_id:)` | Set user variables |
 | `focus` | Get current focus state |

data/Rakefile

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "bundler/gem_tasks"
 require "rspec/core/rake_task"
 
 RSpec::Core::RakeTask.new(:spec)

data/bin/iterm2ctl

@@ -21,20 +21,22 @@ module ITerm2CTL
     when "read-screen"      then cmd_read_screen(args)
     when "raise"            then cmd_raise(args)
     when "activate-session" then cmd_activate_session(args)
-    when "create"    then cmd_create(args)
-    when "split"     then cmd_split(args)
-    when "close"     then cmd_close(args)
-    when "move"      then cmd_move(args)
-    when "var"       then cmd_var(args)
-    when "info"      then cmd_info(args)
-    when "focus"     then cmd_focus(args)
-    when "prompt"    then cmd_prompt(args)
-    when "watch"     then cmd_watch(args)
-    when "profile"   then cmd_profile(args)
-    when "inject"    then cmd_inject(args)
-    when "profiles"  then cmd_profiles(args)
-    when "version"   then puts "iterm2ctl #{ITerm2::VERSION}"
-    when "help", nil then usage
+    when "create"           then cmd_create(args)
+    when "set-window-frame" then cmd_set_window_frame(args)
+    when "get-window-frame" then cmd_get_window_frame(args)
+    when "split"            then cmd_split(args)
+    when "close"            then cmd_close(args)
+    when "move"             then cmd_move(args)
+    when "var"              then cmd_var(args)
+    when "info"             then cmd_info(args)
+    when "focus"            then cmd_focus(args)
+    when "prompt"           then cmd_prompt(args)
+    when "watch"            then cmd_watch(args)
+    when "profile"          then cmd_profile(args)
+    when "inject"           then cmd_inject(args)
+    when "profiles"         then cmd_profiles(args)
+    when "version"          then puts "iterm2ctl #{ITerm2::VERSION}"
+    when "help", nil        then usage
     else
       $stderr.puts "Unknown command: #{command}"
       usage
@@ -73,6 +75,8 @@ module ITerm2CTL
         activate-session ID         Activate a session directly
         raise --cwd PATH            Raise tab by working directory
         create [window|tab]         Create a new window or tab
+        set-window-frame ID X Y W H Move/resize a window (pixels)
+        get-window-frame ID         Read a window's frame (pixels)
         split [--session ID]        Split the current pane
         close [--session ID]        Close a session
         move --tab ID --to-window ID  Move a tab to another window
@@ -310,6 +314,40 @@ module ITerm2CTL
     end
   end
 
+  def cmd_set_window_frame(args)
+    window_id, *numbers = args
+    x, y, w, h = numbers.map { |n| Integer(n, exception: false) }
+
+    if window_id.nil? || numbers.size != 4 || [x, y, w, h].any?(&:nil?)
+      $stderr.puts "Usage: iterm2ctl set-window-frame WINDOW_ID X Y WIDTH HEIGHT"
+      exit 1
+    end
+
+    ITerm2.connect do |client|
+      client.set_window_frame(window_id, x: x, y: y, width: w, height: h)
+      puts "Set frame for window #{window_id}: #{w}x#{h} at (#{x}, #{y})"
+    end
+  end
+
+  def cmd_get_window_frame(args)
+    window_id = args.shift
+    json_mode = args.delete("--json")
+
+    if window_id.nil?
+      $stderr.puts "Usage: iterm2ctl get-window-frame WINDOW_ID [--json]"
+      exit 1
+    end
+
+    ITerm2.connect do |client|
+      frame = client.get_window_frame(window_id)
+      if json_mode
+        puts JSON.pretty_generate(frame)
+      else
+        puts "x=#{frame[:x]} y=#{frame[:y]} width=#{frame[:width]} height=#{frame[:height]}"
+      end
+    end
+  end
+
   def cmd_split(args)
     opts = parse_target_opts(args)
     vertical = !args.delete("--horizontal")

data/docs/api.md

@@ -211,6 +211,39 @@ client.reorder_tabs("window_1" => ["tab_a", "tab_b"])
 
 ---
 
+## Window Frame
+
+iTerm2 opens windows created via `create_tab`/`split_pane` at the profile's default
+size, regardless of what's inside them. These wrap the `"frame"`/`"grid_size"`
+`SetProperty`/`GetProperty` conventions so callers can size a window explicitly.
+
+### `client.get_window_frame(window_id)` -> Hash
+
+```ruby
+{ x: Numeric, y: Numeric, width: Numeric, height: Numeric }  # pixels
+```
+
+**Raises:** `RPCError` on failure (e.g. bogus `window_id`).
+
+### `client.set_window_frame(window_id, x:, y:, width:, height:)` -> true
+
+Moves and resizes a window. All values are pixels.
+
+```ruby
+client.set_window_frame(window_id, x: 0, y: 0, width: 1200, height: 800)
+```
+
+**Raises:** `RPCError` on failure.
+
+### `client.set_session_grid_size(session_id, columns:, rows:)` -> true
+
+Resizes a session's character grid (columns x rows), distinct from `set_window_frame`
+which sizes the window in pixels.
+
+**Raises:** `RPCError` on failure.
+
+---
+
 ## Profile & Properties
 
 ### `client.set_profile_property(session_id, key, value)` -> true | false
@@ -250,8 +283,18 @@ client.list_profiles(properties: ["Name", "Guid"])
 Gets a named property from a session or window. Returns the JSON-decoded value.
 
 ```ruby
-client.get_property("columns", session_id: sid)  # => 120
-client.get_property("frame", window_id: wid)     # => {"origin" => {...}, "size" => {...}}
+client.get_property("grid_size", session_id: sid)  # => {"width" => 80, "height" => 25}
+client.get_property("frame", window_id: wid)        # => {"origin" => {...}, "size" => {...}}
+```
+
+**Raises:** `RPCError` on failure.
+
+### `client.set_property(name, value, session_id: nil, window_id: nil)` -> true
+
+Sets a named property on a session or window. `value` is JSON-encoded before sending.
+
+```ruby
+client.set_property("frame", {origin: {x: 0, y: 0}, size: {width: 800, height: 600}}, window_id: wid)
 ```
 
 **Raises:** `RPCError` on failure.

data/docs/cli.md

@@ -111,6 +111,28 @@ iterm2ctl create tab --window W123...     # new tab in specific window
 iterm2ctl create tab --profile "Custom"   # new tab with profile
 ```
 
+### `set-window-frame`
+
+Move and resize a window. Values are pixels.
+
+```bash
+iterm2ctl set-window-frame W123... 0 0 1200 800
+```
+
+### `get-window-frame`
+
+Read a window's current frame.
+
+```bash
+iterm2ctl get-window-frame W123...          # x=0 y=0 width=1200 height=800
+iterm2ctl get-window-frame W123... --json   # {
+                                             #   "x": 0,
+                                             #   "y": 0,
+                                             #   "width": 1200,
+                                             #   "height": 800
+                                             # }
+```
+
 ### `split`
 
 Split the current pane.

data/lib/iterm2/client.rb

@@ -383,7 +383,7 @@ module ITerm2
       end
     end
 
-    # --- GetProperty ---
+    # --- GetProperty / SetProperty ---
 
     def get_property(name, session_id: nil, window_id: nil)
       req = Proto::GetPropertyRequest.new(name: name)
@@ -396,6 +396,42 @@ module ITerm2
       JSON.parse(resp.json_value)
     end
 
+    def set_property(name, value, session_id: nil, window_id: nil)
+      req = Proto::SetPropertyRequest.new(name: name, json_value: JSON.dump(value))
+      req.session_id = session_id if session_id
+      req.window_id = window_id if window_id
+
+      resp = request(:set_property_request, req).set_property_response
+      raise RPCError, "SetProperty failed: #{resp.status}" unless resp.status == :OK
+
+      true
+    end
+
+    # --- Window Frame ---
+    # Windows open at the profile's default size regardless of content; these
+    # size one explicitly via the "frame"/"grid_size" SetProperty/GetProperty
+    # conventions (see proto/api.proto).
+
+    def get_window_frame(window_id)
+      origin, size = get_property("frame", window_id: window_id).values_at("origin", "size")
+      { x: origin["x"], y: origin["y"], width: size["width"], height: size["height"] }
+    end
+
+    def set_window_frame(window_id, x:, y:, width:, height:)
+      set_property(
+        "frame",
+        { "origin" => { "x" => x, "y" => y }, "size" => { "width" => width, "height" => height } },
+        window_id: window_id
+      )
+    end
+
+    # Resizes a session's character grid (columns x rows). Distinct from
+    # set_window_frame -- this sizes the text grid a session renders, in
+    # cells rather than points.
+    def set_session_grid_size(session_id, columns:, rows:)
+      set_property("grid_size", { "width" => columns, "height" => rows }, session_id: session_id)
+    end
+
     # --- Notifications ---
 
     def subscribe(notification_type, session_id: nil, &callback)

data/lib/iterm2/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ITerm2
-  VERSION = "0.2.0"
+  VERSION = "0.3.1"
 end

data/llms.txt

@@ -66,6 +66,7 @@ States: `:editing`, `:running`, `:at_prompt`, `:unavailable`.
 `topology_enriched`, `list_sessions`, `activate_tab`, `activate_window`,
 `raise_by_cwd`, `create_tab`, `split_pane`, `close_session`, `close_tab`,
 `set_profile_property`, `get_profile_property`, `list_profiles`, `get_property`,
+`set_property`, `window_frame`, `set_window_frame`, `set_session_grid_size`,
 `get_variables`, `set_variables`, `inject`, `reorder_tabs`, `topology_for_aggregator`.
 
 ## Notifications
@@ -90,6 +91,8 @@ iterm2ctl focus             # show focus state
 iterm2ctl info              # show session details
 iterm2ctl move --tab ID --to-window ID  # move tab between windows
 iterm2ctl watch             # stream events as JSON
+iterm2ctl set-window-frame ID X Y W H  # move/resize a window (pixels)
+iterm2ctl get-window-frame ID          # read a window's frame (pixels)
 ```
 
 Most commands accept `--session ID`, `--tab ID`, `--window ID`, `--json`.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: iterm2_ruby
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Forrest Chang
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-02 00:00:00.000000000 Z
+date: 2026-09-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-protobuf