samagotchi 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 220ee751308788beff6b5185350bafe29023706f2e63daf45c8bffab023e173e
-  data.tar.gz: 184c4bc6f92476939901813d8a9b20353a73bb64eb5725d3564ca302bf27559e
+  metadata.gz: ca1d3be1642f5b3a7eb95aad166a1d613e125d5f82d6c79e27f54860c676650f
+  data.tar.gz: 839db8c02d67e9dab21143e00d19aa04ff09eddf974598f24a5811719001c70d
 SHA512:
-  metadata.gz: 7349948ddc41e8ccce71e742d4fc81f51f52290b56a2943efc690adc6e73e4c41fe37fa94dee41c50e20a0c910b3c66a55176955048bf3efa2003e9520c36642
-  data.tar.gz: a2059d2df83be31064bfb05f311c7088e777d2901fa00695f4f52208af3b21038471d7180ad26761b6f3f280a7b2f347f560ca39517e0bfcd52715247ba88477
+  metadata.gz: 06d07b5787fa0f5fdcc71c43ad19bbc22f36670030907d841c78ea5ad103569b514c356e493a55b8d669925a35b4ce63ccb6217dcb1209f3e54530477cc1de45
+  data.tar.gz: 36edb5314aba266d1724b270ccc6f1645372431b1db3a173519f71ca641b31636531a63fecad7f5ff3af6218fffbca9268a46d0d1d1eb4e030851e519c992ae9

data/CHANGELOG.md

@@ -8,6 +8,18 @@ and commands may change between minor versions. How releases are made:
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-09-30
+
+### Added
+
+- The desktop helper also sends to agent CLIs (claude, codex, …) in kitty windows: with `kitty.listen_on` copied
+  from kitty.conf (and `chi desktop upgrade`), the panel lists them in a "kitty" group next to the sessions; ⏎
+  pastes the quote, message and image paths and presses Enter, the new ⌥⏎ only pastes (so several screenshots
+  can pile up), and one send can go to chi sessions and kitty windows together. ⌥⏎ no longer inserts a newline
+  in the panel (⇧⏎ does). See docs/desktop.md "Agents in kitty".
+
+Update with `chi update`. No bundle versions changed.
+
 ## [0.6.0] - 2026-09-30
 
 ### Added
@@ -393,7 +405,8 @@ and long-lived sessions.
 - A macOS desktop helper (`chi desktop install`): a "Send to chi" Service and a
   hotkey panel that send selected text or the clipboard to your sessions.
 
-[Unreleased]: https://github.com/dm1try/samagotchi/compare/v0.6.0...HEAD
+[Unreleased]: https://github.com/dm1try/samagotchi/compare/v0.7.0...HEAD
+[0.7.0]: https://github.com/dm1try/samagotchi/compare/v0.6.0...v0.7.0
 [0.6.0]: https://github.com/dm1try/samagotchi/compare/v0.5.1...v0.6.0
 [0.5.1]: https://github.com/dm1try/samagotchi/compare/v0.5.0...v0.5.1
 [0.5.0]: https://github.com/dm1try/samagotchi/compare/v0.4.0...v0.5.0

data/docs/configuration.md

@@ -687,6 +687,23 @@ hosts:
 `models:` wins over `hosts:`. On a native host, `vision: true` skips only the
 modalities check: without a media marker the prompt can't carry an image.
 
+## Desktop helper: agents in kitty
+
+The desktop helper (`chi desktop`) can also paste into agent CLIs (claude,
+codex, …) running in [kitty](https://sw.kovidgoyal.net/kitty/) windows. It
+lists them only with `kitty.listen_on` set: copy the value of `listen_on` from
+your `kitty.conf` as it is (kitty must also have `allow_remote_control` on).
+
+```yaml
+kitty:
+  listen_on: unix:/tmp/kitty.${KITTY_PID}   # as in kitty.conf; unset = no kitty targets
+  binary: /Applications/kitty.app/Contents/MacOS/kitty   # the default
+  agents: [claude, codex]   # the programs listed; "*" = every window
+```
+
+The helper reads these from its launch file: after editing them run
+`chi desktop upgrade` (or `chi update`). See [Desktop helper](desktop.md#agents-in-kitty).
+
 ## Project specific description
 
 If an AGENT.md file is present in the project root, samagotchi injects its
@@ -756,6 +773,9 @@ described in their own sections.
 | `update.gem` | `true` | | `false`: `chi update` never installs a newer gem (`--no-gem` for one run). See [CLI: Updating](cli.md#updating). |
 | `update.bundles` | `true` | | `false`: `chi update` leaves the shipped bundles to `chi bundle upgrade` (`--no-bundles`). |
 | `update.desktop` | `true` | | `false`: `chi update` leaves the desktop helper alone (`--no-desktop`). |
+| `kitty.listen_on` | none | | The desktop helper's kitty socket, copied from `kitty.conf`; unset = no kitty targets. See "Desktop helper: agents in kitty". |
+| `kitty.binary` | `/Applications/kitty.app/Contents/MacOS/kitty` | | The kitty the helper runs `kitty @` with. |
+| `kitty.agents` | `claude\|codex\|gemini\|aider\|opencode\|cursor-agent\|amp\|goose` | | Foreground programs whose kitty windows the helper lists, `\|`-separated (a YAML list works too); `*` lists every window. |
 | `read.truncate_at_bytes` | `65536` | yes | A `read` result larger than this is cut to a preview. |
 | `read.preview_bytes` | `12288` | yes | Size of that preview. |
 | `read.hard_max_bytes` | `2097152` | yes | Largest file `read` opens. |

data/docs/desktop.md

@@ -20,6 +20,8 @@ sessions. Keys:
 - **⏎** sends a message: `chi send -m <the line>` with the text as quoted context above it. With the line empty,
   the text is the message.
 - **⌘⏎** sends a note: `chi note`, the line (if any) then the text.
+- **⌥⏎** pastes into an agent in a kitty window without pressing Enter (see [Agents in kitty](#agents-in-kitty));
+  it is not a newline.
 - **⇧⏎** is a newline, in either field. Esc closes.
 
 The list shows the sessions a worker runs now, then, under a "recent" divider, up to 3 stopped ones (dimmed, with
@@ -64,6 +66,53 @@ thumbnails sit under the message line, 48 px high, the file name as a tooltip; h
   the panel closes; files from Finder are sent as they are, never touched. A send with images may take up to 30 s
   (converting, a worker starting) before the panel gives up.
 
+## Agents in kitty
+
+The panel can also send to agent CLIs (claude, codex, gemini, aider, …) running in
+[kitty](https://sw.kovidgoyal.net/kitty/) windows, next to chi sessions. kitty only, through its remote control;
+off until you set it up:
+
+1. In `kitty.conf`, remote control on and a socket: `allow_remote_control yes` and a `listen_on unix:…` line.
+2. Copy that `listen_on` value as it is into chi's config.yml:
+
+   ```yaml
+   kitty:
+     listen_on: unix:/tmp/kitty.${KITTY_PID}
+   ```
+
+   `kitty.agents` picks the programs listed (default `claude|codex|gemini|aider|opencode|cursor-agent|amp|goose`, a
+   YAML list works too; `"*"` lists every window, shells too), `kitty.binary` the kitty to run (default
+   `/Applications/kitty.app/Contents/MacOS/kitty`). See [Configuration](configuration.md#desktop-helper-agents-in-kitty).
+3. Run `chi desktop upgrade` (or `chi update`): the helper reads these from its launch file, so **after every edit of
+   `kitty:`** run it again. No rebuild when only the settings changed.
+
+The helper finds the sockets itself: kitty adds `-<pid>` to a `listen_on` path from kitty.conf (and fills in
+`{kitty_pid}`), `~` and variables the helper knows are expanded, others (`${KITTY_PID}`) stay as written, as kitty
+keeps them. Several kitty instances all count. Only `unix:` sockets work.
+
+The panel lists the windows whose foreground program is one of the agents under a **kitty** divider, between live
+and recent sessions: "claude · <its title>", the folder below, a terminal icon, and a ⌘ number like the sessions.
+With the settings on but no agent running, one dim line says "no agents in kitty". A window counts when a foreground
+process's program is an agent, also as the script of `node …/codex` (that match is untested for codex and gemini).
+
+- **⏎** pastes into every chosen window and presses Enter: the text as a `> ` quote, a blank line, your message, then
+  one image path per line. Chosen together with chi sessions, each gets the message and the panel shows one line
+  ("Sent. · sent to claude · samagotchi").
+- **⌥⏎** only pastes (no Enter), and only when every chosen target is a kitty window: build up several screenshots,
+  each with its own line, then press Enter in kitty. The footer shows **Paste ⌥⏎** instead of Note then.
+- **⌘⏎** with a kitty window chosen beeps: "Notes are for chi sessions". ⌥⏎ with a chi session: "Paste only is
+  for kitty windows".
+- **Images:** a screenshot or other image data is copied to `$TMPDIR/chi-helper-sent/<uuid>.png` (or `.tiff`) and
+  its path pasted; the agent reads it from there (claude attaches it as `[Image #1]`). These files are deleted a week
+  later, at the helper's next start. Finder files are pasted with their own path, `'…'`-quoted when they hold spaces.
+- The paste arrives as one bracketed paste, so the agent takes newlines as text (claude shows long ones as
+  `[Pasted text]`). With `agents: "*"` beware of a program that doesn't turn bracketed paste on: the newlines would
+  act as Enter.
+- No delivery confirmation: before pasting, the helper checks the window is still there ("window closed" if not);
+  it can't know whether the agent read it. The 16 KB cap is chi's; a kitty window takes more.
+- Focus goes back to the app you came from, as for sessions. The last choice (kitty windows too) is preselected
+  while listed; ⌘ numbers shift as windows come and go.
+
 ## Install
 
 ```sh

data/lib/samagotchi/bundles/system/manifest.yml

@@ -1,6 +1,6 @@
 ---
 name: samagotchi-system
-version: 0.6.0
+version: 0.7.0
 scope: system
 description: Default system memories — identity, self map, config modification protocol, memory guide and the delegated-session rules
 files:

data/lib/samagotchi/config.rb

@@ -135,6 +135,11 @@ module Samagotchi
       Entry.new(key: "update.gem",               yaml_path: %w[update gem],               type: :bool,    default: true,            expose: %i[env config]),
       Entry.new(key: "update.bundles",           yaml_path: %w[update bundles],           type: :bool,    default: true,            expose: %i[env config]),
       Entry.new(key: "update.desktop",           yaml_path: %w[update desktop],           type: :bool,    default: true,            expose: %i[env config]),
+      # The desktop helper's kitty targets (Desktop::MacOS.kitty_settings): listen_on copied from kitty.conf (unset = none),
+      # the kitty binary, and the foreground programs listed, "|"-separated (a YAML list works too; "*" = every window).
+      Entry.new(key: "kitty.listen_on",          yaml_path: %w[kitty listen_on],          type: :string, default: nil,              expose: %i[env config]),
+      Entry.new(key: "kitty.binary",             yaml_path: %w[kitty binary],             type: :string, default: "/Applications/kitty.app/Contents/MacOS/kitty", expose: %i[env config]),
+      Entry.new(key: "kitty.agents",             yaml_path: %w[kitty agents],             type: :string, default: "claude|codex|gemini|aider|opencode|cursor-agent|amp|goose", expose: %i[env config]),
 
       Entry.new(key: "read.truncate_at_bytes",        yaml_path: %w[read truncate_at_bytes],        type: :integer, default: 65_536,   expose: %i[env config cli]),
       Entry.new(key: "read.preview_bytes",            yaml_path: %w[read preview_bytes],            type: :integer, default: 12_288,   expose: %i[env config cli]),

data/lib/samagotchi/desktop/macos/App.swift

@@ -2,7 +2,8 @@
 // (text, or images: files in Finder, a picture in Preview), the hotkey with
 // the clipboard (a screenshot too). No Dock icon (LSUIElement); it stays
 // running after the first launch. `ChiHelper --login on|off|status` (run
-// directly by chi desktop) manages the login item and exits.
+// directly by chi desktop) manages the login item and exits;
+// `ChiHelper --kitty list|send` is the kitty targets' seam (Kitty.swift).
 import AppKit
 import ServiceManagement
 
@@ -97,6 +98,9 @@ struct ChiHelperMain {
     if args.count >= 2, args[1] == "--login" {
       exit(loginCommand(args.count >= 3 ? args[2] : ""))
     }
+    if args.count >= 2, args[1] == "--kitty" {
+      exit(kittyCommand(Array(args.dropFirst(2))))
+    }
     let app = NSApplication.shared
     let delegate = AppDelegate()
     app.delegate = delegate

data/lib/samagotchi/desktop/macos/ChiRunner.swift

@@ -7,13 +7,8 @@ struct LaunchConfig: Decodable {
   let version: String?
   let argv: [String]
   let env: [String: String]?
-}
-
-struct ChiResult {
-  let status: Int32
-  let stdout: String
-  let stderr: String
-  let timedOut: Bool
+  /// Agents in kitty windows (Kitty.swift); nil = none.
+  let kitty: KittySettings?
 }
 
 enum ChiError: Error, CustomStringConvertible {
@@ -106,9 +101,8 @@ final class ChiRunner {
     return config
   }
 
-  /// Runs `chi <args>`, with stdin written from a background queue and
-  /// stdout/stderr drained as they come (no pipe deadlock near the 16 KiB
-  /// note cap). Calls back on the main queue.
+  /// Runs `chi <args>` through ProcessRunner (no pipe deadlock near the
+  /// 16 KiB note cap). Calls back on the main queue.
   /// @param timeout this call's limit instead of the runner's
   func run(_ args: [String], stdin: Data? = nil, timeout: TimeInterval? = nil,
            completion: @escaping (Result<ChiResult, ChiError>) -> Void) {
@@ -119,59 +113,9 @@ final class ChiRunner {
       completion(.failure(.failed("\(error)"))); return
     }
 
-    let process = Process()
-    process.executableURL = URL(fileURLWithPath: config.argv[0])
-    process.arguments = Array(config.argv.dropFirst()) + args
-    process.environment = ProcessInfo.processInfo.environment.merging(config.env ?? [:]) { _, baked in baked }
-    process.currentDirectoryURL = URL(fileURLWithPath: NSHomeDirectory())
-    let out = Pipe(), err = Pipe(), input = Pipe()
-    process.standardOutput = out
-    process.standardError = err
-    process.standardInput = stdin == nil ? FileHandle.nullDevice : input
-
-    let lock = NSLock()
-    var outData = Data(), errData = Data()
-    out.fileHandleForReading.readabilityHandler = { handle in
-      let chunk = handle.availableData
-      lock.lock(); outData.append(chunk); lock.unlock()
-    }
-    err.fileHandleForReading.readabilityHandler = { handle in
-      let chunk = handle.availableData
-      lock.lock(); errData.append(chunk); lock.unlock()
-    }
-
-    var timedOut = false
-    process.terminationHandler = { proc in
-      out.fileHandleForReading.readabilityHandler = nil
-      err.fileHandleForReading.readabilityHandler = nil
-      let restOut = out.fileHandleForReading.readDataToEndOfFile()
-      let restErr = err.fileHandleForReading.readDataToEndOfFile()
-      lock.lock()
-      outData.append(restOut); errData.append(restErr)
-      let result = ChiResult(status: proc.terminationStatus,
-                             stdout: String(decoding: outData, as: UTF8.self),
-                             stderr: String(decoding: errData, as: UTF8.self),
-                             timedOut: timedOut)
-      lock.unlock()
-      DispatchQueue.main.async { completion(.success(result)) }
-    }
-
-    do { try process.run() } catch {
-      completion(.failure(.failed("Could not start \(config.argv[0]): \(error.localizedDescription)")))
-      return
-    }
-    if let stdin {
-      DispatchQueue.global().async {
-        try? input.fileHandleForWriting.write(contentsOf: stdin)
-        try? input.fileHandleForWriting.close()
-      }
-    }
-    DispatchQueue.global().asyncAfter(deadline: .now() + (timeout ?? self.timeout)) {
-      if process.isRunning {
-        lock.lock(); timedOut = true; lock.unlock()
-        process.terminate()
-      }
-    }
+    ProcessRunner.run(executable: config.argv[0], args: Array(config.argv.dropFirst()) + args,
+                      env: ProcessInfo.processInfo.environment.merging(config.env ?? [:]) { _, baked in baked },
+                      stdin: stdin, timeout: timeout ?? self.timeout, completion: completion)
   }
 
   /// The live sessions, then up to +recentCount+ stopped ones, newest

data/lib/samagotchi/desktop/macos/Images.swift

@@ -27,7 +27,11 @@ struct PanelImage: Identifiable, Equatable {
 }
 
 enum ImageIntake {
-  static let tempDir = URL(fileURLWithPath: NSTemporaryDirectory()).appendingPathComponent("chi-helper", isDirectory: true)
+  /// $TMPDIR when set (launchd sets it; a spec points it elsewhere), else
+  /// the user's temp folder.
+  static let tempRoot = URL(fileURLWithPath: ProcessInfo.processInfo.environment["TMPDIR"].flatMap { $0.isEmpty ? nil : $0 }
+    ?? NSTemporaryDirectory(), isDirectory: true)
+  static let tempDir = tempRoot.appendingPathComponent("chi-helper", isDirectory: true)
 
   /// A pasteboard's content for the panel, in this order: image files
   /// (Finder ⌘C, a Service on files) with no text; else its text, as before
@@ -78,9 +82,40 @@ enum ImageIntake {
     }
   }
 
-  /// At launch: what a helper that quit mid-send left.
-  static func sweep() {
+  /// Images pasted into kitty windows, kept for the agent to read after
+  /// the send: never deleted by it, swept at launch after a week.
+  static let sentDir = tempRoot.appendingPathComponent("chi-helper-sent", isDirectory: true)
+  static let sentMaxAge: TimeInterval = 7 * 86_400
+
+  /// The paths a kitty paste names: an image the helper wrote is copied to
+  /// sentDir first (the send deletes the original), with no spaces in its
+  /// name; a file of the user's is named as it is. Call before any send
+  /// job starts. An image that can't be copied is left out.
+  static func keepForPaste(_ images: [PanelImage]) -> [String] {
+    images.compactMap { image in
+      guard image.temp else { return image.url.path }
+      let ext = image.url.pathExtension.isEmpty ? "png" : image.url.pathExtension
+      let copy = sentDir.appendingPathComponent("\(UUID().uuidString).\(ext)")
+      do {
+        try FileManager.default.createDirectory(at: sentDir, withIntermediateDirectories: true)
+        try FileManager.default.copyItem(at: image.url, to: copy)
+        return copy.path
+      } catch {
+        return nil
+      }
+    }
+  }
+
+  /// At launch: what a helper that quit mid-send left, and pasted images
+  /// older than a week.
+  static func sweep(now: Date = Date()) {
     try? FileManager.default.removeItem(at: tempDir)
+    let fm = FileManager.default
+    for name in (try? fm.contentsOfDirectory(atPath: sentDir.path)) ?? [] {
+      let url = sentDir.appendingPathComponent(name)
+      let modified = (try? fm.attributesOfItem(atPath: url.path)[.modificationDate] as? Date) ?? now
+      if now.timeIntervalSince(modified) > sentMaxAge { try? fm.removeItem(at: url) }
+    }
   }
 }