feat(tui): background running compose with command-b

Author: danielkov

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "kit"
-version = "0.1.82"
+version = "0.1.83"
 edition = "2024"
 rust-version = "1.94.0"
 publish = false
@@ -77,6 +77,12 @@ windows-sys = { version = "=0.61.2", features = [
     "Win32_UI_WindowsAndMessaging",
 ] }
 
+[patch.crates-io]
+agentkit-capabilities = { git = "https://github.com/danielkov/agentkit.git", rev = "d2391a0" }
+agentkit-core = { git = "https://github.com/danielkov/agentkit.git", rev = "d2391a0" }
+agentkit-task-manager = { git = "https://github.com/danielkov/agentkit.git", rev = "d2391a0" }
+agentkit-tools-core = { git = "https://github.com/danielkov/agentkit.git", rev = "d2391a0" }
+
 [dev-dependencies]
 jsonwebtoken = { version = "=11.0.0", default-features = false, features = ["aws_lc_rs", "use_pem"] }
 tempfile = "=3.27.0"

Cargo.toml

@@ -349,8 +349,11 @@ top-level `background` argument. `background: true` starts it in the background;
 it if it is still running. `false` or omission keeps normal foreground behavior.
 The delay must be an integer from 1 through 86,400 seconds.
 
-Detached calls remain visible and selectable in the TUI runtime graph. Interrupting
-the originating turn does not stop them. The model receives each detached call's ID
+Press `Command+B` in the TUI to move the newest running foreground top-level
+compose call into the background. This shortcut requires a terminal that reports
+the Command key through the Kitty keyboard protocol; there is no control-key equivalent. Detached calls
+remain visible and selectable in the TUI runtime graph. Interrupting the originating
+turn does not stop them. The model receives each detached call's ID
 and can cancel it with `close({ call_id: "call_..." })`; the selected running
 background call can also be killed with `Ctrl+K` in the TUI. Completion and
 cancellation are delivered through the normal background-result lifecycle. Detached
@@ -514,6 +517,7 @@ child process with `KIT_RUNTIME_EVENTS=1`; other ACP hosts never see them.
 | `/model name` | switch immediately to the closest catalog match |
 | `⇧⏎`, `⌥⏎`, `^j` | newline |
 | `esc` | interrupt the running turn |
+| `⌘b` | move the newest running foreground compose call to the background |
 | `^c` | interrupt, or quit when idle |
 | `⌥←/→`, `^a`/`^e`, `home`/`end` | word and line movement |
 | `⌥⌫`, `^w` | delete the previous word |

README.md

@@ -25,6 +25,7 @@ A session ID must be 1–128 ASCII letters, digits, `-`, or `_`. `kit prompt` us
 | `Enter` | Send a non-empty prompt when idle |
 | `Shift+Enter`, `Option+Enter`, `Ctrl+J` | Insert a newline |
 | `Esc` | Interrupt a running turn; dismiss a notice when idle |
+| `Command+B` | Move the newest running foreground top-level compose call to the background |
 | `Ctrl+C` | Interrupt a running turn; clear a non-empty idle prompt; quit when idle with an empty prompt |
 | `Ctrl+D` | Quit when the prompt is empty |
 | `Option+Left/Right`, `Ctrl+A`/`Ctrl+E`, `Home`/`End` | Move by word or to the start/end of a line |
@@ -63,7 +64,7 @@ Press `Esc` or `Ctrl+C` once to request cancellation. The TUI shows `interruptin
 
 If a turn does not stop, press `Ctrl+C` again while Kit is cancelling to leave the TUI and terminate its agent child. On normal exit during a turn, Kit first requests cancellation and briefly allows the turn to unwind so tool outcomes can be persisted, then closes the session and releases its lock.
 
-Interrupting a turn does not stop detached background calls. Select a running background tool card and press `Ctrl+K` to kill only that call; the selected title is accented and shows `^k kill`. When a background result starts an autonomous agent continuation, the TUI displays it as an active turn, and `Esc` or `Ctrl+C` interrupts it normally.
+Press `Command+B` to detach the newest running foreground top-level compose call without waiting for it to finish. This shortcut requires a terminal that reports the Command key through the Kitty keyboard protocol; it has no control-key equivalent. Interrupting a turn does not stop detached background calls. Select a running background tool card and press `Ctrl+K` to kill only that call; the selected title is accented and shows `^k kill`. When a background result starts an autonomous agent continuation, the TUI displays it as an active turn, and `Esc` or `Ctrl+C` interrupts it normally.
 
 At an idle, non-empty editor, `Ctrl+C` clears the prompt instead of unexpectedly discarding it and quitting in one step; press it again with the empty editor to quit.