opencode-ghost 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.2] - 2026-09-25
+
+### Changed
+
+- All ghosts (next-message suggestion and typing completions) render inside
+  the prompt box at the caret; the prompt's hint row (status line) is left
+  alone in every state.
+- Typing ghosts are positioned from absolute screen coordinates (the prompt
+  editor's `screenX/screenY` plus the caret's visual column/row) instead of a
+  relative slot offset, and clear reliably when the input no longer matches.
+- `GHOST_DEBUG=1` makes the plugin emit diagnostic toasts about ghost
+  placement (temporary, for localization feedback).
+## [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 +41,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 +78,9 @@ 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.2...HEAD
+[0.2.2]: https://github.com/ozandogrultan/opencode-ghost/compare/v0.2.1...v0.2.2
+[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
@@ -116,8 +116,9 @@ When enabling, a suggestion is generated immediately for the current session.
   survives the server's automatic title generation, and a periodic sweep (plus
   shutdown cleanup) reaps any leftovers — including sessions orphaned by a
   crash — with no configuration required.
-- Renders the result through the `session_prompt` host slot into the prompt's
-  `hint` row, and accepts it into the input via the prompt ref.
+- Renders the result through the `session_prompt` host slot, ghosted inside
+  the prompt box at the caret, and accepts it into the input via the prompt
+  ref.
 
 ## Caveats
 
@@ -125,8 +126,10 @@ 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`.
-- **`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.
+- **Ghost placement.** All ghosts (next-message suggestion, typing
+  completions) render inside the prompt box right after the caret; opencode
+  exposes no inline-completion API, so the plugin overlays the prompt's
+  editor renderable and never touches the prompt's hint row.
 - **Cost.** One small-model call per turn while enabled. Point `model` at a
   cheap or free model.
 - **`acceptKeys`.** `tab` is also opencode's agent-cycle key; this plugin only

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-ghost",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "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

@@ -19,6 +19,7 @@ const MAX_MESSAGE_CHARS = 800
 const MAX_TRANSCRIPT_CHARS = 6000
 const ENABLED_KEY = "ghost.enabled"
 const MODEL_KEY = "ghost.model"
+const GHOST_DEBUG = Boolean(process.env.GHOST_DEBUG)
 
 const HIDDEN_TOOLS = {
   bash: false,
@@ -262,7 +263,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 +337,132 @@ const tui: TuiPlugin = async (api, rawOptions) => {
     return undefined
   }
 
+  // In-box ghost: an absolutely positioned text node rendered in the slot's
+  // own container, at the caret of the prompt's editor renderable (found by
+  // walking the layout tree). Uses the normal render pipeline, so it is visible
+  // wherever the prompt is. When the editor or container cannot be located
+  // (host layout change) completion falls back to the hint row.
+  const [inBox, setInBox] = createSignal<
+    { sessionID: string; x: number; y: number; text: string } | undefined
+  >()
+  let slotNode: { screenX?: number; screenY?: number } | undefined
+  // 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 = (sessionID: string, text: string): boolean => {
+    setInBox(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 ?? {}
+    // Overlay coordinates are relative to the slot container (it anchors the
+    // absolute overlay), so subtract its screen origin from the editor's.
+    if (
+      !slotNode ||
+      typeof slotNode.screenX !== "number" ||
+      typeof slotNode.screenY !== "number"
+    ) {
+      return false
+    }
+    const x = textarea.screenX - slotNode.screenX + (typeof cursor.visualCol === "number" ? cursor.visualCol : 0)
+    const y = textarea.screenY - slotNode.screenY + (typeof cursor.visualRow === "number" ? cursor.visualRow : 0)
+    setInBox({ sessionID, x, y, text })
+    return true
+  }
+
   const POLL_INTERVAL_MS = 100
   const POOL_TTL_MS = 60_000
   let completionKey = ""
-  const pollTimer = setInterval(() => {
+    const pollTimer = setInterval(() => {
     const sessionID = currentSessionID()
     if (!sessionID) {
-      if (completion()) setCompletion(undefined)
+      if (completion() || inBox()) {
+        setCompletion(undefined)
+        setInBox(undefined)
+      }
       return
     }
     const input = promptRef?.current.input ?? ""
     if (poolFetchedAt && Date.now() - poolFetchedAt > POOL_TTL_MS) void refreshPool()
-    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 ?? ""}`
+    // `/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
+    let display = ""
+    let insert = ""
+    if (found) {
+      const args = "args" in found ? found.args : undefined
+      const hint = "hint" in found ? found.hint : undefined
+      insert = found.insert ?? ""
+      display = args && args.length > 0 ? `[${args.join(" | ")}]` : (found.ghost ?? hint ?? "")
+    } else if (!input.trim()) {
+      // Empty prompt: the model's next-message suggestion is ghosted in the
+      // box as well (the accept layer's `accept()` handles Tab for it).
+      const next = ghost()
+      if (next && next.sessionID === sessionID) display = next.text
+    }
+    // Include the display in the key: a fresh suggestion for an unchanged
+    // (empty) input must still be re-placed.
+    const key = `${sessionID}\u0000${input}\u0000${display}`
+    if (completionKey === key) return
+    completionKey = key
+    const drawn = display ? placeInBoxGhost(sessionID, display) : false
+    if (!drawn) setInBox(undefined)
+    if (GHOST_DEBUG && (display || input.startsWith("/"))) {
+      const overlay = inBox()
+      try {
+        api.ui.toast({
+          title: "ghost-debug",
+          message: `display=${display.slice(0, 20) || "∅"} drawn=${drawn} slot=${slotNode ? `${slotNode.screenX}/${slotNode.screenY}` : "n"} box=${overlay ? `${overlay.x}/${overlay.y}` : "∅"}`,
+        })
+      } catch {
+        // ignore
+      }
+    }
     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?.()
 
@@ -613,42 +711,39 @@ const tui: TuiPlugin = async (api, rawOptions) => {
     order: 60,
     slots: {
       session_prompt(_ctx, props) {
-        const suggestion = () => {
-          const current = ghost()
-          return current && current.sessionID === props.session_id ? current.text : ""
-        }
-        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 ?? ""
+        const overlay = () => {
+          const current = inBox()
+          return current && current.sessionID === props.session_id ? current : undefined
         }
         return (
-          <api.ui.Prompt
-            sessionID={props.session_id}
-            visible={props.visible}
-            disabled={props.disabled}
-            showPlaceholder={false}
-            hint={
-              suggestion() || completionText() ? (
-                <box marginLeft={1}>
-                  <text fg={api.theme.current.textMuted}>
-                    {completionText() || suggestion()}
-                  </text>
-                </box>
-              ) : undefined
-            }
-            right={<api.ui.Slot name="session_prompt_right" session_id={props.session_id} />}
-            onSubmit={() => {
-              showGhost(undefined)
-              props.on_submit?.()
-            }}
-            ref={(ref) => {
-              promptRef = ref
-              props.ref?.(ref)
+          <box
+            position="relative"
+            ref={(ref: { screenX?: number; screenY?: number }) => {
+              slotNode = ref
             }}
-          />
+          >
+            <api.ui.Prompt
+              sessionID={props.session_id}
+              visible={props.visible}
+              disabled={props.disabled}
+              showPlaceholder={false}
+              right={<api.ui.Slot name="session_prompt_right" session_id={props.session_id} />}
+              onSubmit={() => {
+                showGhost(undefined)
+                setInBox(undefined)
+                props.on_submit?.()
+              }}
+              ref={(ref) => {
+                promptRef = ref
+                props.ref?.(ref)
+              }}
+            />
+            {overlay() ? (
+              <box position="absolute" left={overlay()!.x} top={overlay()!.y} zIndex={100}>
+                <text fg={api.theme.current.textMuted}>{overlay()!.text}</text>
+              </box>
+            ) : undefined}
+          </box>
         )
       },
     },
@@ -686,6 +781,7 @@ const tui: TuiPlugin = async (api, rawOptions) => {
     if (timer) clearTimeout(timer)
     clearInterval(sweepTimer)
     clearInterval(pollTimer)
+    setInBox(undefined)
     offIdle()
     offStatus()
     backLayer()