opencode-ghost 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-09-24
+
+### Changed
+
+- Slash-command completion now stays out of the way of opencode's native slash
+  menu (the plugin only ghosts argument options after a complete `/name `).
+- Typing ghosts (argument options, prompt history) render inside the prompt
+  input box right after the caret instead of the hint row, falling back to the
+  hint row when the prompt's editor renderable cannot be located.
 ## [0.2.0] - 2026-09-24
 
 ### Added
@@ -20,6 +29,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   pulls the full line back.
 - New option `argHints` (per-command argument option lists for the completion
   hints).
+
 ## [0.1.1] - 2026-09-24
 
 ### Added
@@ -56,7 +66,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Options for `model`, `acceptKeys`, `maxChars`, `idleDelayMs`,
   `recentMessages` and `system`.
 
-[Unreleased]: https://github.com/ozandogrultan/opencode-ghost/compare/v0.2.0...HEAD
+[Unreleased]: https://github.com/ozandogrultan/opencode-ghost/compare/v0.2.1...HEAD
+[0.2.1]: https://github.com/ozandogrultan/opencode-ghost/compare/v0.2.0...v0.2.1
 [0.2.0]: https://github.com/ozandogrultan/opencode-ghost/compare/v0.1.1...v0.2.0
 [0.1.1]: https://github.com/ozandogrultan/opencode-ghost/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/ozandogrultan/opencode-ghost/releases/tag/v0.1.0

package/README.md

@@ -17,14 +17,14 @@ dimmed ghost text you accept with <kbd>Tab</kbd> (or <kbd>→</kbd>).
   default) for one line that sounds like you.
 - **Ghost text, `Tab` to accept.** The suggestion renders under the prompt;
   `Tab` or `→` drops it into the input so you can edit and send.
-- **Slash-command autocomplete while typing.** When the input starts with `/`,
-  the remaining command name is ghosted from configured commands, skills, and
-  the builtin TUI commands; known argument options render as `[a | b]` hints.
-  Tab completes in stages (command name, then each argument). Purely local — no
-  model calls.
+- **Slash-command argument ghosts while typing.** After `/name `, argument
+  option hints (from `argHints` or learned from builtins) render inside the
+  prompt input box, right after the caret, like Claude Code's inline ghosts.
+  Tab completes the next argument. While the command name is still being typed,
+  opencode's own slash menu stays in charge. Purely local — no model calls.
 - **History ghost while typing.** If the line you are typing is a prefix of a
-  message you already sent in the same session, the rest of it is ghosted as
-  well, Tab pulls the full line back. Also purely local.
+  message you already sent in the same session, the rest of it is ghosted in
+  the box as well; Tab pulls the full line back. Also purely local.
 - **`/suggest` toggles it.** State is stored in the plugin KV.
 
 ## Requirements
@@ -125,6 +125,11 @@ When enabling, a suggestion is generated immediately for the current session.
   through that slot, so this plugin replaces the default prompt component. It
   forwards `on_submit`, `ref`, `right`, `visible`, and `disabled`, and cannot be
   combined with another plugin that also renders `session_prompt`.
+- **Ghost placement.** Typing ghosts are drawn directly into the prompt
+  buffer after the caret (opencode exposes no inline-completion API, so the
+  plugin overlays the prompt's editor renderable). When the layout cannot be
+  located, they fall back to the prompt's hint row. The next-prompt
+  suggestion always uses the hint row.
 - **`hint` row.** While a suggestion is showing it occupies the prompt's hint
   row, so the working-directory label is hidden until you accept or type.
 - **Cost.** One small-model call per turn while enabled. Point `model` at a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-ghost",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Claude Code-style next-prompt suggestions in the opencode TUI, shown as dimmed ghost text and accepted with Tab. An opencode plugin.",
   "type": "module",
   "license": "MIT",

package/src/tui.tsx

@@ -262,7 +262,7 @@ const tui: TuiPlugin = async (api, rawOptions) => {
 
   const [ghost, setGhost] = createSignal<{ sessionID: string; text: string } | undefined>()
   const [completion, setCompletion] = createSignal<
-    { sessionID: string; ghost?: string; insert?: string; args?: string[]; hint?: string } | undefined
+    { sessionID: string; display: string; insert?: string; drawn: boolean } | undefined
   >()
   let promptRef: TuiPromptRef | undefined
   let timer: ReturnType<typeof setTimeout> | undefined
@@ -336,35 +336,118 @@ const tui: TuiPlugin = async (api, rawOptions) => {
     return undefined
   }
 
+  // In-box ghost: the suggestion is drawn directly into the prompt's text area
+  // right after the caret, refreshed each frame. When the text area cannot be
+  // located (host layout change), completion falls back to the hint row.
+  let inBoxGhost: { x: number; y: number; text: string } | undefined
+  const drawGhost = (buffer: unknown) => {
+    const target = inBoxGhost
+    if (!target) return
+    try {
+      const drawn = buffer as { drawText?: (text: string, x: number, y: number, fg: unknown) => void }
+      drawn.drawText?.(target.text, target.x, target.y, api.theme.current.textMuted)
+    } catch {
+      // Rendering must never fail because of the overlay.
+    }
+  }
+  const postProcesses = (api.renderer as unknown as { postProcessFns?: unknown[] } | undefined)
+    ?.postProcessFns
+  if (Array.isArray(postProcesses)) postProcesses.push(drawGhost)
+  const removeOverlay = () => {
+    if (!postProcesses) return
+    const index = postProcesses.indexOf(drawGhost)
+    if (index >= 0) postProcesses.splice(index, 1)
+  }
+
+  // Locate the prompt's editor renderable inside the layout tree.
+  const findTextarea = (): unknown => {
+    const root = (api.renderer as unknown as { root?: unknown }).root as
+      | { getChildren?: () => unknown[] }
+      | undefined
+    if (!root) return undefined
+    const stack: unknown[] = [root]
+    while (stack.length) {
+      const node = stack.pop() as
+        | {
+            editBuffer?: unknown
+            editorView?: unknown
+            visualCursor?: { visualRow?: number; visualCol?: number }
+            screenX?: number
+            screenY?: number
+            getChildren?: () => unknown[]
+          }
+        | undefined
+      if (!node) continue
+      if (node.editBuffer && node.editorView && node.visualCursor) return node
+      const children = typeof node.getChildren === "function" ? node.getChildren() : []
+      stack.push(...children)
+    }
+    return undefined
+  }
+
+  const placeInBoxGhost = (text: string): boolean => {
+    inBoxGhost = undefined
+    const textarea = findTextarea() as
+      | { screenX?: unknown; screenY?: unknown; visualCursor?: { visualRow?: number; visualCol?: number } }
+      | undefined
+    if (
+      !textarea ||
+      typeof textarea.screenX !== "number" ||
+      typeof textarea.screenY !== "number"
+    ) {
+      return false
+    }
+    const cursor = textarea.visualCursor ?? {}
+    inBoxGhost = {
+      x: textarea.screenX + (typeof cursor.visualCol === "number" ? cursor.visualCol : 0),
+      y: textarea.screenY + (typeof cursor.visualRow === "number" ? cursor.visualRow : 0),
+      text,
+    }
+    return true
+  }
+
   const POLL_INTERVAL_MS = 100
   const POOL_TTL_MS = 60_000
   let completionKey = ""
   const pollTimer = setInterval(() => {
     const sessionID = currentSessionID()
     if (!sessionID) {
+      inBoxGhost = undefined
       if (completion()) setCompletion(undefined)
       return
     }
     const input = promptRef?.current.input ?? ""
     if (poolFetchedAt && Date.now() - poolFetchedAt > POOL_TTL_MS) void refreshPool()
+    // `/name` with no space yet is opencode's native slash menu; the plugin
+    // stays out of its way. Our slash completion only covers `/name args...`.
+    const found = !input.startsWith("/")
+      ? historyCandidate(sessionID, input)
+      : input.includes(" ")
+        ? completeCommand(input, commandPool, opts.argHints)
+        : undefined
     const key = `${sessionID}\u0000${input}`
-    const found = input.startsWith("/")
-      ? completeCommand(input, commandPool, opts.argHints)
-      : historyCandidate(sessionID, input)
-    if (completionKey === `${key}\u0000${found?.insert ?? ""}`) return
-    completionKey = `${key}\u0000${found?.insert ?? ""}`
+    const insert = found?.insert ?? ""
+    if (completionKey === `${key}\u0000${insert}`) return
+    completionKey = `${key}\u0000${insert}`
+    let display = ""
+    if (found) {
+      const args = "args" in found ? found.args : undefined
+      const hint = "hint" in found ? found.hint : undefined
+      display = args && args.length > 0 ? `[${args.join(" | ")}]` : (found.ghost ?? hint ?? "")
+    }
+    inBoxGhost = undefined
+    const drawn = display ? placeInBoxGhost(display) : false
     setCompletion(
       found
         ? {
             sessionID,
-            ghost: found.ghost,
-            insert: found.insert,
-            args: "args" in found ? found.args : undefined,
-            hint: "hint" in found ? found.hint : undefined,
+            display,
+            insert,
+            drawn,
           }
         : undefined,
     )
-    setAcceptVisible(Boolean(found?.insert) || Boolean(ghost()))
+    setAcceptVisible(Boolean(insert) || Boolean(ghost()))
   }, POLL_INTERVAL_MS)
   pollTimer.unref?.()
 
@@ -620,9 +703,9 @@ const tui: TuiPlugin = async (api, rawOptions) => {
         const completionText = () => {
           const current = completion()
           if (!current || current.sessionID !== props.session_id) return ""
-          if (current.args && current.args.length > 0) return `[${current.args.join(" | ")}]`
-          if (current.hint) return current.hint
-          return current.ghost ?? ""
+          // In in-box mode `drawGhost` handles the text; the hint row then stays free.
+          if (current.drawn) return ""
+          return current.display
         }
         return (
           <api.ui.Prompt
@@ -686,6 +769,7 @@ const tui: TuiPlugin = async (api, rawOptions) => {
     if (timer) clearTimeout(timer)
     clearInterval(sweepTimer)
     clearInterval(pollTimer)
+    removeOverlay()
     offIdle()
     offStatus()
     backLayer()