opencode-cut 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 aiev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# opencode-cut
+
+OpenCode V2 TUI plugin that makes `Ctrl+X` cut selected text in prompt and dialog inputs.
+
+The plugin copies the selected text to the system clipboard first and deletes it only after the clipboard write succeeds. If the input, selection, or focused editor changes while copying, it is left untouched. Repeated cut requests are ignored while a copy is pending.
+
+## Install
+
+Add the package to the terminal client plugin list and move OpenCode's default leader key away from `Ctrl+X`:
+
+```jsonc
+// ~/.config/opencode/cli.json
+{
+  "plugins": ["opencode-cut"],
+  "keybinds": {
+    "leader": "alt+x"
+  }
+}
+```
+
+OpenCode reloads valid `cli.json` changes while running. Restart the terminal client if the plugin is not picked up immediately.
+
+## Usage
+
+1. Select text in an OpenCode input with `Shift` plus the arrow keys.
+2. Press `Ctrl+X`.
+3. Paste it elsewhere with that application's paste shortcut (`Ctrl+V` in OpenCode).
+
+With no input selection, `Ctrl+X` does nothing. Existing leader shortcuts continue to work with `Alt+X`; for example, `Alt+X`, then `N` creates a new session.
+
+## Clipboard behavior
+
+The plugin uses the native operating-system clipboard through [`clipboardy`](https://github.com/sindresorhus/clipboardy). Linux requires a working X11 or Wayland clipboard (for example, `xsel` or `wl-copy`); macOS and Windows use their native clipboard tools.
+
+If the clipboard write fails, an error toast is shown and the selection is preserved. OSC 52 is not used because sending an escape sequence does not confirm that a terminal accepted the text. Headless/SSH environments need access to a native clipboard, such as X11 forwarding.
+
+Requires OpenCode V2. Development and npm tooling require Node.js 20 or newer. The command ID is `aiev.cut` and can be rebound under `keybinds` in `cli.json`. The plugin does not change your leader automatically; keep the `leader` setting above when using `Ctrl+X`.
+
+## Local development
+
+```bash
+npm install
+npm run typecheck
+npm test
+npm run build
+```
+
+Load the working copy by adding its absolute path to `~/.config/opencode/cli.json`:
+
+```json
+{
+  "plugins": ["/absolute/path/to/opencode-cut"]
+}
+```
+
+## License
+
+MIT

package/dist/clipboard.d.ts

@@ -0,0 +1,2 @@
+/** A terminal escape write alone cannot confirm a successful clipboard copy. */
+export declare function copyText(text: string): Promise<void>;

package/dist/clipboard.js

@@ -0,0 +1,5 @@
+import clipboard from "clipboardy";
+/** A terminal escape write alone cannot confirm a successful clipboard copy. */
+export async function copyText(text) {
+    await clipboard.write(text);
+}

package/dist/cut.d.ts

@@ -0,0 +1,10 @@
+import type { EditBufferRenderable } from "@opentui/core";
+export type CutEditor = Pick<EditBufferRenderable, "deleteSelection" | "getSelectedText" | "getSelection" | "hasSelection" | "plainText">;
+export type CutResult = "cut" | "no-selection" | "selection-changed";
+export type CopyText = (text: string) => Promise<unknown>;
+/**
+ * Copies and then deletes one editor selection. The selection is checked again
+ * after the asynchronous clipboard write so a changed selection is never
+ * deleted accidentally.
+ */
+export declare function cutSelectedText(editor: CutEditor, copy?: CopyText, isCurrent?: () => boolean): Promise<CutResult>;

package/dist/cut.js

@@ -0,0 +1,29 @@
+import { copyText } from "./clipboard.js";
+function sameSelection(left, right) {
+    return left !== null && right !== null && left.start === right.start && left.end === right.end;
+}
+/**
+ * Copies and then deletes one editor selection. The selection is checked again
+ * after the asynchronous clipboard write so a changed selection is never
+ * deleted accidentally.
+ */
+export async function cutSelectedText(editor, copy = copyText, isCurrent = () => true) {
+    const selection = editor.getSelection();
+    if (!selection || !editor.hasSelection())
+        return "no-selection";
+    const range = { ...selection };
+    const content = editor.plainText;
+    const text = editor.getSelectedText();
+    if (!text)
+        return "no-selection";
+    await copy(text);
+    if (!isCurrent())
+        return "selection-changed";
+    const currentSelection = editor.getSelection();
+    if (editor.plainText !== content ||
+        !sameSelection(range, currentSelection) ||
+        editor.getSelectedText() !== text) {
+        return "selection-changed";
+    }
+    return editor.deleteSelection() ? "cut" : "selection-changed";
+}

package/dist/tui.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from "@opencode/plugin/tui";
+export declare const CUT_COMMAND_ID = "aiev.cut";
+declare const mod: Plugin.Definition;
+export default mod;

package/dist/tui.js

@@ -0,0 +1,69 @@
+import { cutSelectedText } from "./cut.js";
+export const CUT_COMMAND_ID = "aiev.cut";
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+const mod = {
+    id: "aiev.cut.tui",
+    setup(context) {
+        let active = true;
+        let copying = false;
+        const unregister = context.ui.slot({
+            append: "app",
+            render: () => {
+                context.keymap.layer(() => ({
+                    mode: "global",
+                    target: () => context.renderer.currentFocusedEditor,
+                    priority: 100,
+                    commands: [
+                        {
+                            id: CUT_COMMAND_ID,
+                            title: "Cut selected text",
+                            description: "Copy the selected input text to the clipboard and remove it",
+                            group: "Text Editing",
+                            bind: "ctrl+x",
+                            palette: true,
+                            enabled: () => Boolean(context.renderer.currentFocusedEditor?.hasSelection()),
+                            run: () => {
+                                if (copying)
+                                    return;
+                                const editor = context.renderer.currentFocusedEditor;
+                                if (!editor?.hasSelection())
+                                    return false;
+                                copying = true;
+                                return cutSelectedText(editor, undefined, () => active && context.renderer.currentFocusedEditor === editor)
+                                    .then((result) => {
+                                    if (!active || result !== "selection-changed")
+                                        return;
+                                    context.ui.toast.show({
+                                        message: "Input or focus changed while copying; text was copied but not deleted.",
+                                        variant: "warning",
+                                    });
+                                })
+                                    .catch((error) => {
+                                    if (!active)
+                                        return;
+                                    context.ui.toast.show({
+                                        title: "Cut failed",
+                                        message: `${errorMessage(error)}. The selection was not deleted.`,
+                                        variant: "error",
+                                    });
+                                })
+                                    .finally(() => {
+                                    copying = false;
+                                });
+                            },
+                        },
+                    ],
+                    bindings: [CUT_COMMAND_ID],
+                }));
+                return null;
+            },
+        });
+        return () => {
+            active = false;
+            unregister();
+        };
+    },
+};
+export default mod;

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "opencode-cut",
+  "version": "0.1.0",
+  "description": "OpenCode V2 TUI plugin that adds real clipboard-aware cut support to text inputs",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    "./tui": {
+      "types": "./dist/tui.d.ts",
+      "import": "./tui/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "tui",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "tsx --test tests/*.test.ts",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "tui",
+    "clipboard",
+    "cut"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aiev/opencode-cut.git"
+  },
+  "bugs": {
+    "url": "https://github.com/aiev/opencode-cut/issues"
+  },
+  "homepage": "https://github.com/aiev/opencode-cut#readme",
+  "author": "aiev",
+  "license": "MIT",
+  "dependencies": {
+    "clipboardy": "^5.3.2"
+  },
+  "peerDependencies": {
+    "@opentui/core": ">=0.5.10"
+  },
+  "devDependencies": {
+    "@opencode/plugin": "^2.0.16",
+    "@opentui/core": "^0.5.10",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.22.3",
+    "typescript": "^5.8.0"
+  }
+}

package/src/clipboard.ts

@@ -0,0 +1,6 @@
+import clipboard from "clipboardy"
+
+/** A terminal escape write alone cannot confirm a successful clipboard copy. */
+export async function copyText(text: string): Promise<void> {
+  await clipboard.write(text)
+}

package/src/cut.ts

@@ -0,0 +1,50 @@
+import type { EditBufferRenderable } from "@opentui/core"
+import { copyText } from "./clipboard.js"
+
+export type CutEditor = Pick<
+  EditBufferRenderable,
+  "deleteSelection" | "getSelectedText" | "getSelection" | "hasSelection" | "plainText"
+>
+
+export type CutResult = "cut" | "no-selection" | "selection-changed"
+export type CopyText = (text: string) => Promise<unknown>
+
+function sameSelection(
+  left: { start: number; end: number } | null,
+  right: { start: number; end: number } | null,
+): boolean {
+  return left !== null && right !== null && left.start === right.start && left.end === right.end
+}
+
+/**
+ * Copies and then deletes one editor selection. The selection is checked again
+ * after the asynchronous clipboard write so a changed selection is never
+ * deleted accidentally.
+ */
+export async function cutSelectedText(
+  editor: CutEditor,
+  copy: CopyText = copyText,
+  isCurrent: () => boolean = () => true,
+): Promise<CutResult> {
+  const selection = editor.getSelection()
+  if (!selection || !editor.hasSelection()) return "no-selection"
+
+  const range = { ...selection }
+  const content = editor.plainText
+  const text = editor.getSelectedText()
+  if (!text) return "no-selection"
+
+  await copy(text)
+
+  if (!isCurrent()) return "selection-changed"
+  const currentSelection = editor.getSelection()
+  if (
+    editor.plainText !== content ||
+    !sameSelection(range, currentSelection) ||
+    editor.getSelectedText() !== text
+  ) {
+    return "selection-changed"
+  }
+
+  return editor.deleteSelection() ? "cut" : "selection-changed"
+}

package/src/tui.ts

@@ -0,0 +1,76 @@
+import type { Plugin } from "@opencode/plugin/tui"
+import { cutSelectedText } from "./cut.js"
+
+export const CUT_COMMAND_ID = "aiev.cut"
+
+function errorMessage(error: unknown): string {
+  return error instanceof Error ? error.message : String(error)
+}
+
+const mod: Plugin.Definition = {
+  id: "aiev.cut.tui",
+
+  setup(context) {
+    let active = true
+    let copying = false
+    const unregister = context.ui.slot({
+      append: "app",
+      render: () => {
+        context.keymap.layer(() => ({
+          mode: "global",
+          target: () => context.renderer.currentFocusedEditor,
+          priority: 100,
+          commands: [
+            {
+              id: CUT_COMMAND_ID,
+              title: "Cut selected text",
+              description: "Copy the selected input text to the clipboard and remove it",
+              group: "Text Editing",
+              bind: "ctrl+x",
+              palette: true,
+              enabled: () => Boolean(context.renderer.currentFocusedEditor?.hasSelection()),
+              run: () => {
+                if (copying) return
+                const editor = context.renderer.currentFocusedEditor
+                if (!editor?.hasSelection()) return false
+
+                copying = true
+                return cutSelectedText(
+                  editor,
+                  undefined,
+                  () => active && context.renderer.currentFocusedEditor === editor,
+                )
+                  .then((result) => {
+                    if (!active || result !== "selection-changed") return
+                    context.ui.toast.show({
+                      message: "Input or focus changed while copying; text was copied but not deleted.",
+                      variant: "warning",
+                    })
+                  })
+                  .catch((error) => {
+                    if (!active) return
+                    context.ui.toast.show({
+                      title: "Cut failed",
+                      message: `${errorMessage(error)}. The selection was not deleted.`,
+                      variant: "error",
+                    })
+                  })
+                  .finally(() => {
+                    copying = false
+                  })
+              },
+            },
+          ],
+          bindings: [CUT_COMMAND_ID],
+        }))
+        return null
+      },
+    })
+    return () => {
+      active = false
+      unregister()
+    }
+  },
+}
+
+export default mod

package/tui/index.js

@@ -0,0 +1,7 @@
+// Stable TUI entry point. The TypeScript implementation is built to dist/.
+import mod from "../dist/tui.js"
+
+export default {
+  id: "aiev.cut.tui",
+  setup: mod.setup,
+}