@@ -416,7 +416,7 @@ export interface KeymapCommand {
   /** Enables or disables the command. */
   readonly enabled?: boolean | (() => boolean)
   /** Configures automatic binding, or disables it for a named command. */
-  readonly bind?: false | string
+  readonly bind?: false | string | { key: string; event?: "press" | "release" }
   /** Adds a named command to the command palette. */
   readonly palette?: true
   /** Adds a named command to prompt slash completion. */
 
@@ -241,8 +241,16 @@ function createLayer(input: () => KeymapLayer) {
           if (command.bind === false) return []
           const configured = value.config.keybinds.get(command.id)
           if (configured.length) return configured
-          if (typeof command.bind !== "string") return []
-          return [{ key: command.bind, cmd: command.id }]
+          if (typeof command.bind === "string") return [{ key: command.bind, cmd: command.id }]
+          if (typeof command.bind === "object" && command.bind.key)
+            return [
+              {
+                key: command.bind.key,
+                cmd: command.id,
+                ...(command.bind.event === undefined ? {} : { event: command.bind.event }),
+              },
+            ]
+          return []
         }),
         ...(bindings ?? []).flatMap((id) => value.config.keybinds.get(id)),
       ],
@@ -257,6 +265,8 @@ function groupCommands(commands: readonly KeymapCommand[] = []) {
         if (!command.id) throw new Error("Keymap command IDs cannot be empty")
         if (typeof command.bind === "string" && !command.bind)
           throw new Error("Keymap command bindings cannot be empty")
+        if (typeof command.bind === "object" && !command.bind.key)
+          throw new Error("Keymap command bindings cannot be empty")
         result.named.push({ ...command, id: command.id })
         return result
       }
 
@@ -1,5 +1,6 @@
 /** @jsxImportSource @opentui/solid */
 import { testRender } from "@opentui/solid"
+import { useKeymapSelector } from "@opentui/keymap/solid"
 import { expect, test } from "bun:test"
 import { ConfigProvider } from "../src/config"
 import { Keymap } from "../src/context/keymap"
@@ -139,3 +140,31 @@ test("global commands stay reachable when the mode changes", async () => {
     app.renderer.destroy()
   }
 })
+
+test("layer object bindings carry release events", async () => {
+  let read = () => ""
+
+  function Harness() {
+    const bindings = useKeymapSelector((keymap) =>
+      keymap.getCommandBindings({ visibility: "registered", commands: ["voice.release"] }),
+    )
+    Keymap.createLayer(() => ({
+      commands: [{ id: "voice.release", bind: { key: "f9", event: "release" }, run() {} }],
+    }))
+    read = () => bindings().get("voice.release")?.[0]?.event ?? ""
+    return <box />
+  }
+
+  const app = await testRender(() => (
+    <ConfigProvider config={createTuiResolvedConfig()}>
+      <Keymap.Provider>
+        <Harness />
+      </Keymap.Provider>
+    </ConfigProvider>
+  ))
+  try {
+    expect(read()).toBe("release")
+  } finally {
+    app.renderer.destroy()
+  }
+})