From 17c2413be72116b47df5fb87985bd6104d5ced76 Mon Sep 17 00:00:00 2001
From: Sylwester Liljegren <sylwester.liljegren@softronic.se>
Date: Sun, 23 Aug 2026 19:26:17 +0200
Subject: [PATCH 1/2] feat(vscode): add Display setting for prompt navigator
 rail position

The prompt navigator rail was hardcoded to the left edge of the transcript. Add a Prompt Navigator Position setting under Settings > Display so it can be moved to the right edge instead, with left kept as the default.

The rail, its hover card placement, tick growth direction, and open animation all mirror to the selected side. The new prompt_rail_position key is added to the shared config schema so the backend accepts it, and to the generated SDK contract.
---
 .changeset/prompt-navigator-position.md       |  5 ++++
 packages/core/src/v1/config/config.ts         |  5 ++++
 .../src/components/chat/MessageList.tsx       |  8 +++--
 .../src/components/chat/PromptRail.tsx        | 28 ++++++++++++-----
 .../src/components/settings/DisplayTab.tsx    | 30 +++++++++++++++++--
 .../src/components/settings/settings-io.ts    |  1 +
 .../kilo-vscode/webview-ui/src/i18n/ar.ts     |  5 ++++
 .../kilo-vscode/webview-ui/src/i18n/br.ts     |  6 ++++
 .../kilo-vscode/webview-ui/src/i18n/bs.ts     |  6 ++++
 .../kilo-vscode/webview-ui/src/i18n/da.ts     |  5 ++++
 .../kilo-vscode/webview-ui/src/i18n/de.ts     |  6 ++++
 .../kilo-vscode/webview-ui/src/i18n/en.ts     |  5 ++++
 .../kilo-vscode/webview-ui/src/i18n/es.ts     |  6 ++++
 .../kilo-vscode/webview-ui/src/i18n/fa.ts     |  6 ++++
 .../kilo-vscode/webview-ui/src/i18n/fr.ts     |  6 ++++
 .../kilo-vscode/webview-ui/src/i18n/it.ts     |  6 ++++
 .../kilo-vscode/webview-ui/src/i18n/ja.ts     |  6 ++++
 .../kilo-vscode/webview-ui/src/i18n/ko.ts     |  6 ++++
 .../kilo-vscode/webview-ui/src/i18n/nl.ts     |  6 ++++
 .../kilo-vscode/webview-ui/src/i18n/no.ts     |  6 ++++
 .../kilo-vscode/webview-ui/src/i18n/pl.ts     |  6 ++++
 .../kilo-vscode/webview-ui/src/i18n/ru.ts     |  6 ++++
 .../kilo-vscode/webview-ui/src/i18n/th.ts     |  5 ++++
 .../kilo-vscode/webview-ui/src/i18n/tr.ts     |  6 ++++
 .../kilo-vscode/webview-ui/src/i18n/uk.ts     |  6 ++++
 .../kilo-vscode/webview-ui/src/i18n/zh.ts     |  5 ++++
 .../kilo-vscode/webview-ui/src/i18n/zht.ts    |  5 ++++
 .../webview-ui/src/styles/prompt-rail.css     | 29 ++++++++++++++++++
 .../webview-ui/src/types/messages/config.ts   |  2 ++
 packages/sdk/js/src/v2/gen/types.gen.ts       |  1 +
 packages/sdk/openapi.json                     |  4 +++
 31 files changed, 221 insertions(+), 12 deletions(-)
 create mode 100644 .changeset/prompt-navigator-position.md

diff --git a/.changeset/prompt-navigator-position.md b/.changeset/prompt-navigator-position.md
new file mode 100644
index 00000000000..6831a32ada5
--- /dev/null
+++ b/.changeset/prompt-navigator-position.md
@@ -0,0 +1,5 @@
+---
+"kilo-code": minor
+---
+
+Add a Display setting to choose whether the prompt navigator rail sits on the left or right edge of the chat. The rail, its hover card, and its open animation mirror to the selected side, and the choice applies everywhere the transcript is shown, including the sidebar, Kilo editor tabs, the sub-agent viewer, and Agent Manager. Left remains the default.
diff --git a/packages/core/src/v1/config/config.ts b/packages/core/src/v1/config/config.ts
index 5dd4d7612cc..5bd7671816d 100644
--- a/packages/core/src/v1/config/config.ts
+++ b/packages/core/src/v1/config/config.ts
@@ -133,6 +133,11 @@ export const Info = Schema.Struct({
     description:
       "Controls whether MCP and generic tool blocks are expanded or collapsed by default in the VS Code chat UI",
   }),
+  // kilocode_change start
+  prompt_rail_position: Schema.optional(Schema.Literals(["left", "right"])).annotate({
+    description: "Controls which edge of the chat the prompt navigator rail appears on",
+  }),
+  // kilocode_change end
   hide_prompt_training_models: Schema.optional(Schema.Boolean).annotate({
     description: "Hide Kilo Gateway models that may train on your prompts from model listings",
   }),
diff --git a/packages/kilo-vscode/webview-ui/src/components/chat/MessageList.tsx b/packages/kilo-vscode/webview-ui/src/components/chat/MessageList.tsx
index 63b8ec7d946..3a7128a00da 100644
--- a/packages/kilo-vscode/webview-ui/src/components/chat/MessageList.tsx
+++ b/packages/kilo-vscode/webview-ui/src/components/chat/MessageList.tsx
@@ -27,6 +27,7 @@ import { createAutoScroll } from "@kilocode/kilo-ui/hooks"
 import { useSession } from "../../context/session"
 import { useServer } from "../../context/server"
 import { useLanguage } from "../../context/language"
+import { useConfig } from "../../context/config"
 import { useI18n } from "@kilocode/kilo-ui/context/i18n"
 import { useProvider } from "../../context/provider"
 import { useWorktreeMode } from "../../context/worktree-mode"
@@ -81,7 +82,7 @@ import {
   parseProviderAuthError,
   unwrapError,
 } from "../../utils/errorUtils"
-import type { Part, QuestionRequest, SuggestionRequest, ToolState } from "../../types/messages"
+import type { Part, PromptRailPosition, QuestionRequest, SuggestionRequest, ToolState } from "../../types/messages"
 
 interface MessageListProps {
   onSelectSession?: (id: string) => void
@@ -104,6 +105,7 @@ export const MessageList: Component<MessageListProps> = (props) => {
   const session = useSession()
   const server = useServer()
   const language = useLanguage()
+  const config = useConfig()
   const provider = useProvider()
   const i18n = useI18n()
   const data = useData()
@@ -1034,7 +1036,7 @@ export const MessageList: Component<MessageListProps> = (props) => {
   window.addEventListener("scrollToMessage", onScrollToMessage)
   onCleanup(() => window.removeEventListener("scrollToMessage", onScrollToMessage))
 
-  // Prompt rail: one tick per user prompt, positioned to the left of the
+  // Prompt rail: one tick per user prompt, positioned on the edge of the
   // readable lane, opening a card of prompt/answer previews on hover.
   const items = createMemo(() => promptItems(rows()))
   // Until the transcript is measured there is no height to cap against, and
@@ -1042,6 +1044,7 @@ export const MessageList: Component<MessageListProps> = (props) => {
   const entries = createMemo(() => railEntries(items(), capacity(height()), session.hasOlderMessages()))
   const [activeTurn, setActiveTurn] = createSignal<string>()
   const railActiveKey = createMemo(() => items().find((item) => item.turn === activeTurn())?.key)
+  const railPosition = createMemo<PromptRailPosition>(() => config.config().prompt_rail_position ?? "left")
 
   const [seek, setSeek] = createSignal<{ sid: string; count: number }>()
   let paging = false
@@ -1371,6 +1374,7 @@ export const MessageList: Component<MessageListProps> = (props) => {
       </div>
 
       <PromptRail
+        position={railPosition}
         entries={entries}
         items={items}
         active={() => railActiveKey()}
diff --git a/packages/kilo-vscode/webview-ui/src/components/chat/PromptRail.tsx b/packages/kilo-vscode/webview-ui/src/components/chat/PromptRail.tsx
index 0e487aa850a..5d4d383304c 100644
--- a/packages/kilo-vscode/webview-ui/src/components/chat/PromptRail.tsx
+++ b/packages/kilo-vscode/webview-ui/src/components/chat/PromptRail.tsx
@@ -2,7 +2,7 @@
 
 /**
  * PromptRail component
- * Thin vertical summary rail on the left edge of the transcript. Hovering or
+ * Thin vertical summary rail on the edge of the transcript. Hovering or
  * focusing opens a bounded navigator for every loaded prompt; clicking jumps
  * the virtualized transcript without mounting the intervening rows.
  */
@@ -15,8 +15,10 @@ import { Portal } from "solid-js/web"
 import { VList, type VListHandle } from "virtua/solid"
 import { useLanguage } from "../../context/language"
 import { RAIL_INSET, ROW_HEIGHT, TICK_MIN, TICK_STEP, type PromptRailEntry, type PromptRailItem } from "./prompt-rail"
+import type { PromptRailPosition } from "../../types/messages"
 
 interface PromptRailProps {
+  position: Accessor<PromptRailPosition>
   entries: Accessor<PromptRailEntry[]>
   items: Accessor<PromptRailItem[]>
   /** Row key of the item whose turn is currently at the top of the transcript. */
@@ -47,7 +49,7 @@ export function PromptRail(props: PromptRailProps) {
   const [open, setOpen] = createSignal(false)
   const [hover, setHover] = createSignal<string>()
   const [focused, setFocused] = createSignal<number>()
-  const [anchor, setAnchor] = createSignal<{ top: number; left: number; height: number }>()
+  const [anchor, setAnchor] = createSignal<{ top: number; left?: number; right?: number; height: number }>()
   let rail: HTMLElement | undefined
   let card: HTMLDivElement | undefined
   let list: VListHandle | undefined
@@ -96,9 +98,11 @@ export function PromptRail(props: PromptRailProps) {
     const min = Math.max(EDGE, rect.top + 4)
     const max = Math.min(window.innerHeight - EDGE, rect.bottom - 4) - height
     const center = rect.top + rect.height / 2 - height / 2
+    const isRight = props.position() === "right"
     setAnchor({
       top: max < min ? min : Math.min(Math.max(center, min), max),
-      left: rect.right + GAP,
+      left: isRight ? undefined : rect.right + GAP,
+      right: isRight ? window.innerWidth - rect.left + GAP : undefined,
       height: limit,
     })
   }
@@ -252,6 +256,16 @@ export function PromptRail(props: PromptRailProps) {
     props.onLatest()
   }
 
+  const cardStyle = (position: { top: number; left?: number; right?: number; height: number }) => {
+    const style: Record<string, string> = {
+      top: `${position.top}px`,
+      "--prompt-rail-card-height": `${position.height}px`,
+    }
+    if (position.left !== undefined) style.left = `${position.left}px`
+    if (position.right !== undefined) style.right = `${position.right}px`
+    return style
+  }
+
   const row = (item: PromptRailItem, index: Accessor<number>) => (
     <button
       type="button"
@@ -279,6 +293,7 @@ export function PromptRail(props: PromptRailProps) {
       <nav
         ref={rail}
         class="prompt-rail"
+        data-position={props.position()}
         aria-label={language.t("session.prompts.navLabel")}
         style={{ "--prompt-rail-step": `${step()}px` }}
         onMouseLeave={closeCard}
@@ -328,14 +343,11 @@ export function PromptRail(props: PromptRailProps) {
             <div
               ref={card}
               class="prompt-rail-card"
+              data-position={props.position()}
               data-virtualized={virtualized() || undefined}
               role="dialog"
               aria-label={language.t("session.prompts.navLabel")}
-              style={{
-                top: `${position().top}px`,
-                left: `${position().left}px`,
-                "--prompt-rail-card-height": `${position().height}px`,
-              }}
+              style={cardStyle(position())}
               onMouseEnter={cancelClose}
               onMouseLeave={closeCard}
               onWheel={(event) => {
diff --git a/packages/kilo-vscode/webview-ui/src/components/settings/DisplayTab.tsx b/packages/kilo-vscode/webview-ui/src/components/settings/DisplayTab.tsx
index fbd2e490400..1823800d8c9 100644
--- a/packages/kilo-vscode/webview-ui/src/components/settings/DisplayTab.tsx
+++ b/packages/kilo-vscode/webview-ui/src/components/settings/DisplayTab.tsx
@@ -6,7 +6,7 @@ import { Switch } from "@kilocode/kilo-ui/switch"
 import { useConfig } from "../../context/config"
 import { useDisplay } from "../../context/display"
 import { useLanguage } from "../../context/language"
-import type { CodeEditDisplay, McpToolDisplay, TerminalCommandDisplay } from "../../types/messages"
+import type { CodeEditDisplay, McpToolDisplay, PromptRailPosition, TerminalCommandDisplay } from "../../types/messages"
 import SettingsRow from "./SettingsRow"
 
 interface LayoutOption {
@@ -29,6 +29,11 @@ const MCP_OPTIONS: LayoutOption[] = [
   { value: "collapsed", labelKey: "settings.display.mcpTool.collapsed" },
 ]
 
+const PROMPT_RAIL_OPTIONS: LayoutOption[] = [
+  { value: "left", labelKey: "settings.display.promptRailPosition.left" },
+  { value: "right", labelKey: "settings.display.promptRailPosition.right" },
+]
+
 const DisplayTab: Component = () => {
   const { config, updateConfig, settings, updateSetting } = useConfig()
   const display = useDisplay()
@@ -167,7 +172,6 @@ const DisplayTab: Component = () => {
         <SettingsRow
           title={language.t("settings.display.mcpTool.title")}
           description={language.t("settings.display.mcpTool.description")}
-          last
         >
           <Select
             options={MCP_OPTIONS}
@@ -185,6 +189,28 @@ const DisplayTab: Component = () => {
             triggerVariant="settings"
           />
         </SettingsRow>
+
+        <SettingsRow
+          title={language.t("settings.display.promptRailPosition.title")}
+          description={language.t("settings.display.promptRailPosition.description")}
+          last
+        >
+          <Select
+            options={PROMPT_RAIL_OPTIONS}
+            current={PROMPT_RAIL_OPTIONS.find((o) => o.value === (config().prompt_rail_position ?? "left"))}
+            value={(o) => o.value}
+            label={(o) => language.t(o.labelKey)}
+            onSelect={(o) => {
+              if (!o) return
+              const next = o.value as PromptRailPosition
+              if (next === (config().prompt_rail_position ?? "left")) return
+              updateConfig({ prompt_rail_position: next })
+            }}
+            variant="secondary"
+            size="small"
+            triggerVariant="settings"
+          />
+        </SettingsRow>
       </Card>
     </div>
   )
diff --git a/packages/kilo-vscode/webview-ui/src/components/settings/settings-io.ts b/packages/kilo-vscode/webview-ui/src/components/settings/settings-io.ts
index b03369c8e25..44722cb6b8c 100644
--- a/packages/kilo-vscode/webview-ui/src/components/settings/settings-io.ts
+++ b/packages/kilo-vscode/webview-ui/src/components/settings/settings-io.ts
@@ -39,6 +39,7 @@ export const KNOWN_KEYS: ReadonlyArray<string> = [
   "terminal_command_display",
   "code_edit_display",
   "mcp_tool_display",
+  "prompt_rail_position",
   "hide_prompt_training_models",
   "sandbox",
   "indexing",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/ar.ts b/packages/kilo-vscode/webview-ui/src/i18n/ar.ts
index 527f49dc6d9..100060a01e0 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/ar.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/ar.ts
@@ -1103,6 +1103,11 @@ export const dict = {
   "settings.display.autoApprovalReason.description":
     "إظهار سطر عند استدعاءات الأدوات يوضح سبب الموافقة التلقائية عليها (قاعدة مطابقة، إعداد افتراضي للوكيل، وضع YOLO، إلخ).",
 
+  "settings.display.promptRailPosition.title": "موضع مستعرض المطالبات",
+  "settings.display.promptRailPosition.description": "اختر الحافة التي يظهر عليها شريط مستعرض المطالبات في الدردشة.",
+  "settings.display.promptRailPosition.left": "يسار",
+  "settings.display.promptRailPosition.right": "يمين",
+
   "chat.throughput.tooltip":
     "Average {{speed}} tokens/s for this turn. Includes output and reasoning tokens; excludes tool execution and waiting time.",
   "chat.throughput.tooltip.missing": "Throughput metrics unavailable for this turn.",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/br.ts b/packages/kilo-vscode/webview-ui/src/i18n/br.ts
index f50c4b3c0f4..5866dfb1130 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/br.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/br.ts
@@ -1146,6 +1146,12 @@ export const dict = {
   "settings.display.autoApprovalReason.description":
     "Mostra uma linha nas chamadas de ferramentas explicando por que foram aprovadas automaticamente (regra correspondente, padrão do agente, modo YOLO, etc.).",
 
+  "settings.display.promptRailPosition.title": "Posição do navegador de prompts",
+  "settings.display.promptRailPosition.description":
+    "Escolha em qual borda do chat a barra do navegador de prompts aparece.",
+  "settings.display.promptRailPosition.left": "Esquerda",
+  "settings.display.promptRailPosition.right": "Direita",
+
   "chat.throughput.tooltip":
     "Average {{speed}} tokens/s for this turn. Includes output and reasoning tokens; excludes tool execution and waiting time.",
   "chat.throughput.tooltip.missing": "Throughput metrics unavailable for this turn.",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/bs.ts b/packages/kilo-vscode/webview-ui/src/i18n/bs.ts
index b827e54aea0..2da4c13ac14 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/bs.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/bs.ts
@@ -1137,6 +1137,12 @@ export const dict = {
   "settings.display.autoApprovalReason.description":
     "Prikazuje red uz pozive alata koji objašnjava zašto su automatski odobreni (odgovarajuće pravilo, podrazumevana vrijednost agenta, YOLO režim itd.).",
 
+  "settings.display.promptRailPosition.title": "Položaj navigatora upita",
+  "settings.display.promptRailPosition.description":
+    "Odaberite na kojoj ivici razgovora se prikazuje traka navigatora upita.",
+  "settings.display.promptRailPosition.left": "Lijevo",
+  "settings.display.promptRailPosition.right": "Desno",
+
   "chat.throughput.tooltip":
     "Average {{speed}} tokens/s for this turn. Includes output and reasoning tokens; excludes tool execution and waiting time.",
   "chat.throughput.tooltip.missing": "Throughput metrics unavailable for this turn.",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/da.ts b/packages/kilo-vscode/webview-ui/src/i18n/da.ts
index 678ecb251c4..c265c802a6a 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/da.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/da.ts
@@ -1131,6 +1131,11 @@ export const dict = {
   "settings.display.autoApprovalReason.description":
     "Viser en linje ved værktøjskald, der forklarer, hvorfor de blev automatisk godkendt (matchende regel, agent-standard, YOLO-tilstand osv.).",
 
+  "settings.display.promptRailPosition.title": "Placering af promptnavigator",
+  "settings.display.promptRailPosition.description": "Vælg i hvilken kant af chatten promptnavigatorens bjælke vises.",
+  "settings.display.promptRailPosition.left": "Venstre",
+  "settings.display.promptRailPosition.right": "Højre",
+
   "chat.throughput.tooltip":
     "Average {{speed}} tokens/s for this turn. Includes output and reasoning tokens; excludes tool execution and waiting time.",
   "chat.throughput.tooltip.missing": "Throughput metrics unavailable for this turn.",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/de.ts b/packages/kilo-vscode/webview-ui/src/i18n/de.ts
index 06d8c8c22be..5ade84fca70 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/de.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/de.ts
@@ -1158,6 +1158,12 @@ export const dict = {
   "settings.display.autoApprovalReason.description":
     "Zeigt bei Tool-Aufrufen eine Zeile an, die erklärt, warum sie automatisch genehmigt wurden (passende Regel, Agent-Standard, YOLO-Modus usw.).",
 
+  "settings.display.promptRailPosition.title": "Position der Prompt-Navigation",
+  "settings.display.promptRailPosition.description":
+    "Wählen Sie, an welchem Rand des Chats die Leiste der Prompt-Navigation angezeigt wird.",
+  "settings.display.promptRailPosition.left": "Links",
+  "settings.display.promptRailPosition.right": "Rechts",
+
   "chat.throughput.tooltip":
     "Average {{speed}} tokens/s for this turn. Includes output and reasoning tokens; excludes tool execution and waiting time.",
   "chat.throughput.tooltip.missing": "Throughput metrics unavailable for this turn.",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/en.ts b/packages/kilo-vscode/webview-ui/src/i18n/en.ts
index f1bd0dc7799..386dff5d562 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/en.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/en.ts
@@ -1103,6 +1103,11 @@ export const dict = {
   "settings.display.autoApprovalReason.title": "Show Auto-Approval Reason",
   "settings.display.autoApprovalReason.description":
     "Show a line on tool calls explaining why they were auto-approved (matched rule, agent default, YOLO mode, etc.).",
+  "settings.display.promptRailPosition.title": "Prompt Navigator Position",
+  "settings.display.promptRailPosition.description":
+    "Choose which edge of the chat the prompt navigator rail appears on.",
+  "settings.display.promptRailPosition.left": "Left",
+  "settings.display.promptRailPosition.right": "Right",
 
   "chat.throughput.tooltip":
     "Average {{speed}} tokens/s for this turn. Includes output and reasoning tokens; excludes tool execution and waiting time.",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/es.ts b/packages/kilo-vscode/webview-ui/src/i18n/es.ts
index 49e52639c6a..2af3d55bd8d 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/es.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/es.ts
@@ -1148,6 +1148,12 @@ export const dict = {
   "settings.display.autoApprovalReason.description":
     "Muestra una línea en las llamadas a herramientas que explica por qué se aprobaron automáticamente (regla coincidente, valor predeterminado del agente, modo YOLO, etc.).",
 
+  "settings.display.promptRailPosition.title": "Posición del navegador de prompts",
+  "settings.display.promptRailPosition.description":
+    "Elige en qué borde del chat aparece la barra del navegador de prompts.",
+  "settings.display.promptRailPosition.left": "Izquierda",
+  "settings.display.promptRailPosition.right": "Derecha",
+
   "chat.throughput.tooltip":
     "Average {{speed}} tokens/s for this turn. Includes output and reasoning tokens; excludes tool execution and waiting time.",
   "chat.throughput.tooltip.missing": "Throughput metrics unavailable for this turn.",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/fa.ts b/packages/kilo-vscode/webview-ui/src/i18n/fa.ts
index 66f9ae50703..3cb120a9176 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/fa.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/fa.ts
@@ -1117,6 +1117,12 @@ export const dict = {
   "settings.display.autoApprovalReason.description":
     "نمایش خطی در فراخوانی ابزارها که توضیح می‌دهد چرا به‌طور خودکار تأیید شده‌اند (قانون مطابق، پیش‌فرض عامل، حالت YOLO و غیره).",
 
+  "settings.display.promptRailPosition.title": "موقعیت ناوبر پرامپت",
+  "settings.display.promptRailPosition.description":
+    "انتخاب کنید که نوار ناوبر پرامپت در کدام لبه گفتگو نمایش داده شود.",
+  "settings.display.promptRailPosition.left": "چپ",
+  "settings.display.promptRailPosition.right": "راست",
+
   "chat.throughput.tooltip":
     "میانگین {{speed}} توکن/ثانیه برای این نوبت. شامل توکن‌های خروجی و استدلال می‌شود؛ زمان اجرای ابزار و انتظار را شامل نمی‌شود.",
   "chat.throughput.tooltip.missing": "معیارهای توان عملیاتی برای این نوبت در دسترس نیست.",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/fr.ts b/packages/kilo-vscode/webview-ui/src/i18n/fr.ts
index f3343819257..db9d3baa9d4 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/fr.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/fr.ts
@@ -1166,6 +1166,12 @@ export const dict = {
   "settings.display.autoApprovalReason.description":
     "Affiche une ligne sur les appels d'outils expliquant pourquoi ils ont été approuvés automatiquement (règle correspondante, agent par défaut, mode YOLO, etc.).",
 
+  "settings.display.promptRailPosition.title": "Position du navigateur de prompts",
+  "settings.display.promptRailPosition.description":
+    "Choisissez sur quel bord du chat la barre du navigateur de prompts s'affiche.",
+  "settings.display.promptRailPosition.left": "Gauche",
+  "settings.display.promptRailPosition.right": "Droite",
+
   "chat.throughput.tooltip":
     "Average {{speed}} tokens/s for this turn. Includes output and reasoning tokens; excludes tool execution and waiting time.",
   "chat.throughput.tooltip.missing": "Throughput metrics unavailable for this turn.",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/it.ts b/packages/kilo-vscode/webview-ui/src/i18n/it.ts
index ddeccb4ad8c..2d12caf5e32 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/it.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/it.ts
@@ -1015,6 +1015,12 @@ export const dict = {
   "settings.display.autoApprovalReason.description":
     "Mostra una riga sulle chiamate agli strumenti che spiega perché sono state approvate automaticamente (regola corrispondente, predefinito dell'agente, modalità YOLO, ecc.).",
 
+  "settings.display.promptRailPosition.title": "Posizione del navigatore dei prompt",
+  "settings.display.promptRailPosition.description":
+    "Scegli su quale bordo della chat viene mostrata la barra del navigatore dei prompt.",
+  "settings.display.promptRailPosition.left": "Sinistra",
+  "settings.display.promptRailPosition.right": "Destra",
+
   "chat.throughput.tooltip":
     "Average {{speed}} tokens/s for this turn. Includes output and reasoning tokens; excludes tool execution and waiting time.",
   "chat.throughput.tooltip.missing": "Throughput metrics unavailable for this turn.",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/ja.ts b/packages/kilo-vscode/webview-ui/src/i18n/ja.ts
index 43ac30ffef5..bd29ab0095d 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/ja.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/ja.ts
@@ -1125,6 +1125,12 @@ export const dict = {
   "settings.display.autoApprovalReason.description":
     "ツール呼び出しが自動承認された理由（一致したルール、エージェントのデフォルト、YOLOモードなど）を示す行を表示します。",
 
+  "settings.display.promptRailPosition.title": "プロンプトナビゲーターの位置",
+  "settings.display.promptRailPosition.description":
+    "プロンプトナビゲーターのバーをチャットのどちらの端に表示するかを選択します。",
+  "settings.display.promptRailPosition.left": "左",
+  "settings.display.promptRailPosition.right": "右",
+
   "chat.throughput.tooltip":
     "Average {{speed}} tokens/s for this turn. Includes output and reasoning tokens; excludes tool execution and waiting time.",
   "chat.throughput.tooltip.missing": "Throughput metrics unavailable for this turn.",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/ko.ts b/packages/kilo-vscode/webview-ui/src/i18n/ko.ts
index 1cdc1ba0290..7374121b50d 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/ko.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/ko.ts
@@ -1112,6 +1112,12 @@ export const dict = {
   "settings.display.autoApprovalReason.description":
     "도구 호출이 자동으로 승인된 이유(일치한 규칙, 에이전트 기본값, YOLO 모드 등)를 설명하는 줄을 표시합니다.",
 
+  "settings.display.promptRailPosition.title": "프롬프트 탐색기 위치",
+  "settings.display.promptRailPosition.description":
+    "프롬프트 탐색기 막대를 채팅의 어느 쪽 가장자리에 표시할지 선택합니다.",
+  "settings.display.promptRailPosition.left": "왼쪽",
+  "settings.display.promptRailPosition.right": "오른쪽",
+
   "chat.throughput.tooltip":
     "Average {{speed}} tokens/s for this turn. Includes output and reasoning tokens; excludes tool execution and waiting time.",
   "chat.throughput.tooltip.missing": "Throughput metrics unavailable for this turn.",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/nl.ts b/packages/kilo-vscode/webview-ui/src/i18n/nl.ts
index 33bcc6a81a8..0264c2d75ed 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/nl.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/nl.ts
@@ -1105,6 +1105,12 @@ export const dict = {
   "settings.display.autoApprovalReason.description":
     "Toont een regel bij tool-aanroepen die uitlegt waarom ze automatisch zijn goedgekeurd (overeenkomende regel, agentstandaard, YOLO-modus, enz.).",
 
+  "settings.display.promptRailPosition.title": "Positie van promptnavigator",
+  "settings.display.promptRailPosition.description":
+    "Kies aan welke rand van de chat de balk van de promptnavigator wordt weergegeven.",
+  "settings.display.promptRailPosition.left": "Links",
+  "settings.display.promptRailPosition.right": "Rechts",
+
   "chat.throughput.tooltip":
     "Average {{speed}} tokens/s for this turn. Includes output and reasoning tokens; excludes tool execution and waiting time.",
   "chat.throughput.tooltip.missing": "Throughput metrics unavailable for this turn.",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/no.ts b/packages/kilo-vscode/webview-ui/src/i18n/no.ts
index 9682777b47d..9115225abf1 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/no.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/no.ts
@@ -1131,6 +1131,12 @@ export const dict = {
   "settings.display.autoApprovalReason.description":
     "Viser en linje ved verktøykall som forklarer hvorfor de ble automatisk godkjent (samsvarende regel, agentstandard, YOLO-modus osv.).",
 
+  "settings.display.promptRailPosition.title": "Plassering av ledetekstnavigering",
+  "settings.display.promptRailPosition.description":
+    "Velg hvilken kant av chatten linjen for ledetekstnavigering vises på.",
+  "settings.display.promptRailPosition.left": "Venstre",
+  "settings.display.promptRailPosition.right": "Høyre",
+
   "chat.throughput.tooltip":
     "Average {{speed}} tokens/s for this turn. Includes output and reasoning tokens; excludes tool execution and waiting time.",
   "chat.throughput.tooltip.missing": "Throughput metrics unavailable for this turn.",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/pl.ts b/packages/kilo-vscode/webview-ui/src/i18n/pl.ts
index fbfb49718bd..938d10d93d0 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/pl.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/pl.ts
@@ -1138,6 +1138,12 @@ export const dict = {
   "settings.display.autoApprovalReason.description":
     "Pokazuje wiersz przy wywołaniach narzędzi wyjaśniający, dlaczego zostały automatycznie zatwierdzone (dopasowana reguła, wartość domyślna agenta, tryb YOLO itp.).",
 
+  "settings.display.promptRailPosition.title": "Położenie nawigatora promptów",
+  "settings.display.promptRailPosition.description":
+    "Wybierz, przy której krawędzi czatu wyświetlany jest pasek nawigatora promptów.",
+  "settings.display.promptRailPosition.left": "Lewa",
+  "settings.display.promptRailPosition.right": "Prawa",
+
   "chat.throughput.tooltip":
     "Average {{speed}} tokens/s for this turn. Includes output and reasoning tokens; excludes tool execution and waiting time.",
   "chat.throughput.tooltip.missing": "Throughput metrics unavailable for this turn.",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/ru.ts b/packages/kilo-vscode/webview-ui/src/i18n/ru.ts
index 83f079fa80d..a3258d8b407 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/ru.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/ru.ts
@@ -1132,6 +1132,12 @@ export const dict = {
   "settings.display.autoApprovalReason.description":
     "Показывает строку у вызовов инструментов, объясняющую, почему они были одобрены автоматически (совпавшее правило, значение агента по умолчанию, режим YOLO и т. д.).",
 
+  "settings.display.promptRailPosition.title": "Расположение навигатора промптов",
+  "settings.display.promptRailPosition.description":
+    "Выберите, у какого края чата отображается панель навигатора промптов.",
+  "settings.display.promptRailPosition.left": "Слева",
+  "settings.display.promptRailPosition.right": "Справа",
+
   "chat.throughput.tooltip":
     "Average {{speed}} tokens/s for this turn. Includes output and reasoning tokens; excludes tool execution and waiting time.",
   "chat.throughput.tooltip.missing": "Throughput metrics unavailable for this turn.",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/th.ts b/packages/kilo-vscode/webview-ui/src/i18n/th.ts
index 999677979a2..499a1a8d9f9 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/th.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/th.ts
@@ -1109,6 +1109,11 @@ export const dict = {
   "settings.display.autoApprovalReason.description":
     "แสดงบรรทัดในการเรียกใช้เครื่องมือเพื่ออธิบายว่าเหตุใดจึงได้รับการอนุมัติอัตโนมัติ (กฎที่ตรงกัน ค่าเริ่มต้นของเอเจนต์ โหมด YOLO ฯลฯ)",
 
+  "settings.display.promptRailPosition.title": "ตำแหน่งตัวนำทางพรอมต์",
+  "settings.display.promptRailPosition.description": "เลือกว่าแถบตัวนำทางพรอมต์จะแสดงที่ขอบด้านใดของแชท",
+  "settings.display.promptRailPosition.left": "ซ้าย",
+  "settings.display.promptRailPosition.right": "ขวา",
+
   "chat.throughput.tooltip":
     "Average {{speed}} tokens/s for this turn. Includes output and reasoning tokens; excludes tool execution and waiting time.",
   "chat.throughput.tooltip.missing": "Throughput metrics unavailable for this turn.",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/tr.ts b/packages/kilo-vscode/webview-ui/src/i18n/tr.ts
index 16c46210ad9..273604bfbbf 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/tr.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/tr.ts
@@ -1093,6 +1093,12 @@ export const dict = {
   "settings.display.autoApprovalReason.description":
     "Araç çağrılarının neden otomatik olarak onaylandığını açıklayan bir satır gösterir (eşleşen kural, aracı varsayılanı, YOLO modu vb.).",
 
+  "settings.display.promptRailPosition.title": "Komut Gezgini Konumu",
+  "settings.display.promptRailPosition.description":
+    "Komut gezgini çubuğunun sohbetin hangi kenarında görüneceğini seçin.",
+  "settings.display.promptRailPosition.left": "Sol",
+  "settings.display.promptRailPosition.right": "Sağ",
+
   "chat.throughput.tooltip":
     "Average {{speed}} tokens/s for this turn. Includes output and reasoning tokens; excludes tool execution and waiting time.",
   "chat.throughput.tooltip.missing": "Throughput metrics unavailable for this turn.",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/uk.ts b/packages/kilo-vscode/webview-ui/src/i18n/uk.ts
index 658c0a272b2..6854baa38f8 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/uk.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/uk.ts
@@ -1092,6 +1092,12 @@ export const dict = {
   "settings.display.autoApprovalReason.description":
     "Показує рядок біля викликів інструментів, що пояснює, чому їх автоматично схвалено (відповідне правило, стандартне значення агента, режим YOLO тощо).",
 
+  "settings.display.promptRailPosition.title": "Розташування навігатора запитів",
+  "settings.display.promptRailPosition.description":
+    "Виберіть, біля якого краю чату відображається панель навігатора запитів.",
+  "settings.display.promptRailPosition.left": "Ліворуч",
+  "settings.display.promptRailPosition.right": "Праворуч",
+
   "chat.throughput.tooltip":
     "Average {{speed}} tokens/s for this turn. Includes output and reasoning tokens; excludes tool execution and waiting time.",
   "chat.throughput.tooltip.missing": "Throughput metrics unavailable for this turn.",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/zh.ts b/packages/kilo-vscode/webview-ui/src/i18n/zh.ts
index f4f0768bebd..c024c449df2 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/zh.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/zh.ts
@@ -1071,6 +1071,11 @@ export const dict = {
   "settings.display.autoApprovalReason.description":
     "在工具调用中显示一行说明其被自动批准的原因（匹配的规则、代理默认值、YOLO 模式等）。",
 
+  "settings.display.promptRailPosition.title": "提示词导航位置",
+  "settings.display.promptRailPosition.description": "选择提示词导航条显示在聊天的哪一侧边缘。",
+  "settings.display.promptRailPosition.left": "左侧",
+  "settings.display.promptRailPosition.right": "右侧",
+
   "chat.throughput.tooltip":
     "Average {{speed}} tokens/s for this turn. Includes output and reasoning tokens; excludes tool execution and waiting time.",
   "chat.throughput.tooltip.missing": "Throughput metrics unavailable for this turn.",
diff --git a/packages/kilo-vscode/webview-ui/src/i18n/zht.ts b/packages/kilo-vscode/webview-ui/src/i18n/zht.ts
index f89b1aa9ef1..6cf46f81310 100644
--- a/packages/kilo-vscode/webview-ui/src/i18n/zht.ts
+++ b/packages/kilo-vscode/webview-ui/src/i18n/zht.ts
@@ -1034,6 +1034,11 @@ export const dict = {
   "settings.display.autoApprovalReason.description":
     "在工具呼叫中顯示一行說明其被自動核准的原因（符合的規則、代理預設值、YOLO 模式等）。",
 
+  "settings.display.promptRailPosition.title": "提示詞導覽位置",
+  "settings.display.promptRailPosition.description": "選擇提示詞導覽列顯示在聊天的哪一側邊緣。",
+  "settings.display.promptRailPosition.left": "左側",
+  "settings.display.promptRailPosition.right": "右側",
+
   "chat.throughput.tooltip":
     "Average {{speed}} tokens/s for this turn. Includes output and reasoning tokens; excludes tool execution and waiting time.",
   "chat.throughput.tooltip.missing": "Throughput metrics unavailable for this turn.",
diff --git a/packages/kilo-vscode/webview-ui/src/styles/prompt-rail.css b/packages/kilo-vscode/webview-ui/src/styles/prompt-rail.css
index ee628afc260..0ae3e51eaad 100644
--- a/packages/kilo-vscode/webview-ui/src/styles/prompt-rail.css
+++ b/packages/kilo-vscode/webview-ui/src/styles/prompt-rail.css
@@ -40,6 +40,11 @@
   opacity: 1;
 }
 
+.prompt-rail[data-position="right"] {
+  inset-inline-start: auto;
+  inset-inline-end: var(--prompt-rail-edge);
+}
+
 .prompt-rail-tick {
   pointer-events: auto;
   display: flex;
@@ -57,6 +62,10 @@
   outline: none;
 }
 
+.prompt-rail[data-position="right"] .prompt-rail-tick {
+  justify-content: flex-end;
+}
+
 /* Ticks grow by transform, not by width and height: a rail can hold a hundred
    of them, and a compositor-only transition keeps the hover response smooth
    instead of laying out the line on every frame. The box is the full 16px x 2px
@@ -77,6 +86,10 @@
     box-shadow 0.2s var(--prompt-rail-ease);
 }
 
+.prompt-rail[data-position="right"] .prompt-rail-tick-line {
+  transform-origin: right center;
+}
+
 .prompt-rail-tick[data-queued] .prompt-rail-tick-line {
   background: var(--icon-weaker);
   opacity: 0.5;
@@ -164,6 +177,11 @@
   transform-origin: left center;
 }
 
+.prompt-rail-card[data-position="right"] {
+  transform-origin: right center;
+  animation-name: prompt-rail-in-right;
+}
+
 .prompt-rail-card[data-virtualized] {
   display: flex;
   flex-direction: column;
@@ -254,6 +272,17 @@
   }
 }
 
+@keyframes prompt-rail-in-right {
+  from {
+    opacity: 0;
+    transform: translateX(6px) scale(0.98);
+  }
+  to {
+    opacity: 1;
+    transform: translateX(0) scale(1);
+  }
+}
+
 .prompt-rail-row {
   display: flex;
   flex-direction: column;
diff --git a/packages/kilo-vscode/webview-ui/src/types/messages/config.ts b/packages/kilo-vscode/webview-ui/src/types/messages/config.ts
index ccca1426483..9e206b6616e 100644
--- a/packages/kilo-vscode/webview-ui/src/types/messages/config.ts
+++ b/packages/kilo-vscode/webview-ui/src/types/messages/config.ts
@@ -132,6 +132,7 @@ export interface BrowserSettings {
 export type TerminalCommandDisplay = "expanded" | "collapsed"
 export type CodeEditDisplay = "expanded" | "collapsed"
 export type McpToolDisplay = "expanded" | "collapsed"
+export type PromptRailPosition = "left" | "right"
 
 export interface Config {
   permission?: PermissionConfig
@@ -154,6 +155,7 @@ export interface Config {
   terminal_command_display?: TerminalCommandDisplay
   code_edit_display?: CodeEditDisplay
   mcp_tool_display?: McpToolDisplay
+  prompt_rail_position?: PromptRailPosition
   hide_prompt_training_models?: boolean
   share?: "manual" | "auto" | "disabled"
   username?: string
diff --git a/packages/sdk/js/src/v2/gen/types.gen.ts b/packages/sdk/js/src/v2/gen/types.gen.ts
index c3d8d3f8a4e..e74b8f534c9 100644
--- a/packages/sdk/js/src/v2/gen/types.gen.ts
+++ b/packages/sdk/js/src/v2/gen/types.gen.ts
@@ -2557,6 +2557,7 @@ export type Config = {
   terminal_command_display?: "expanded" | "collapsed"
   code_edit_display?: "expanded" | "collapsed"
   mcp_tool_display?: "expanded" | "collapsed"
+  prompt_rail_position?: "left" | "right"
   hide_prompt_training_models?: boolean
   privacy_mode?: boolean
   /**
diff --git a/packages/sdk/openapi.json b/packages/sdk/openapi.json
index 5ff65448042..3042a393654 100644
--- a/packages/sdk/openapi.json
+++ b/packages/sdk/openapi.json
@@ -33894,6 +33894,10 @@
             "type": "string",
             "enum": ["expanded", "collapsed"]
           },
+          "prompt_rail_position": {
+            "type": "string",
+            "enum": ["left", "right"]
+          },
           "hide_prompt_training_models": {
             "type": "boolean"
           },

From c9ad36f5d348b9a7af81252de79032843839c581 Mon Sep 17 00:00:00 2001
From: Sylwester Liljegren <sylwester.liljegren@softronic.se>
Date: Sun, 23 Aug 2026 21:45:30 +0200
Subject: [PATCH 2/2] fix(vscode): anchor prompt navigator rail physically and
 clear the scrollbar

Addresses review feedback on the prompt navigator position setting.

The rail placed itself with logical insets while place() anchors the hover card with physical getBoundingClientRect/innerWidth math. Under ar/fa the logical inset flipped the rail without flipping that math, so choosing Right put the rail on the physical left and pushed the card roughly a viewport off-screen. The rail now uses physical left/right, which also makes the Left and Right labels literally true, and the tick row is pinned to ltr so its flex alignment stops fighting the physical transform-origin.

The right rail also sat on the transcript's reserved scrollbar gutter and over the scroll-to-bottom button. It now adds the existing --chat-scrollbar-width allowance on whichever physical side the scrollbar is on, and the button is lifted above the rail so ticks cannot swallow its click.

Adds a right-edge Storybook story; the default-rail stories keep the real ConfigProvider so their baselines are untouched.
---
 .../src/components/chat/PromptRail.tsx        |  6 ++++
 .../webview-ui/src/stories/chat.stories.tsx   | 20 +++++++++--
 .../webview-ui/src/styles/chat-layout.css     |  4 +++
 .../webview-ui/src/styles/prompt-rail.css     | 33 ++++++++++++++++---
 4 files changed, 57 insertions(+), 6 deletions(-)

diff --git a/packages/kilo-vscode/webview-ui/src/components/chat/PromptRail.tsx b/packages/kilo-vscode/webview-ui/src/components/chat/PromptRail.tsx
index 5d4d383304c..be2e9de0acc 100644
--- a/packages/kilo-vscode/webview-ui/src/components/chat/PromptRail.tsx
+++ b/packages/kilo-vscode/webview-ui/src/components/chat/PromptRail.tsx
@@ -88,6 +88,12 @@ export function PromptRail(props: PromptRailProps) {
   // and the card never rides up over the task header or down over the composer.
   // Before the card is mounted its height is estimated from the row count; the
   // measured value takes over on the next frame, inside the fade-in.
+  //
+  // The side is anchored physically so the card always opens inward, away from
+  // the panel edge: only one of left/right is ever set, because a fixed element
+  // given both and no width stretches to span the gap between them. This math
+  // is physical in both directions, which is why .prompt-rail places itself
+  // with physical left/right instead of logical insets.
   const place = () => {
     if (!rail) return
     const rect = rail.getBoundingClientRect()
diff --git a/packages/kilo-vscode/webview-ui/src/stories/chat.stories.tsx b/packages/kilo-vscode/webview-ui/src/stories/chat.stories.tsx
index 021d5e8f8bf..5cc41ab5afe 100644
--- a/packages/kilo-vscode/webview-ui/src/stories/chat.stories.tsx
+++ b/packages/kilo-vscode/webview-ui/src/stories/chat.stories.tsx
@@ -28,6 +28,7 @@ import { WorktreeModeProvider } from "../context/worktree-mode"
 import type {
   Message,
   Part,
+  PromptRailPosition,
   QuestionRequest,
   ReviewComment,
   SessionModelUsage,
@@ -614,7 +615,9 @@ const railData = {
   part: railParts,
 }
 
-const renderRailChat = (status: "idle" | "busy" = "idle") => {
+// `position` is only forwarded when a story asks for it, so the default-rail
+// stories keep using the real ConfigProvider and their baselines stay put.
+const renderRailChat = (status: "idle" | "busy" = "idle", position?: PromptRailPosition) => {
   const session = {
     ...mockSessionValue({ id: SESSION_ID, status }),
     messages: () => railMessages,
@@ -622,7 +625,13 @@ const renderRailChat = (status: "idle" | "busy" = "idle") => {
     getParts: (id: string) => railParts[id] ?? [],
   }
   return (
-    <StoryProviders data={railData} sessionID={SESSION_ID} status={status} noPadding>
+    <StoryProviders
+      data={railData}
+      sessionID={SESSION_ID}
+      status={status}
+      config={position ? { prompt_rail_position: position } : undefined}
+      noPadding
+    >
       <SessionContext.Provider value={session as any}>
         <div style={{ height: "100vh", display: "flex", "flex-direction": "column" }}>
           <ChatView />
@@ -642,6 +651,13 @@ export const PromptRailSidebar: Story = {
   render: () => renderRailChat("busy"),
 }
 
+// Right-edge rail: covers the mirrored tick alignment and the scrollbar
+// allowance that keeps the ticks off the transcript scrollbar.
+export const PromptRailRightEdge: Story = {
+  name: "PromptRail - right edge",
+  render: () => renderRailChat("idle", "right"),
+}
+
 // Long session: more prompts than fit the transcript height, so the rail and
 // the card both cap to the newest ones that fit.
 const manyTurns = Array.from({ length: 80 }, (_, i) =>
diff --git a/packages/kilo-vscode/webview-ui/src/styles/chat-layout.css b/packages/kilo-vscode/webview-ui/src/styles/chat-layout.css
index 08cab9f94d4..57cd65650d2 100644
--- a/packages/kilo-vscode/webview-ui/src/styles/chat-layout.css
+++ b/packages/kilo-vscode/webview-ui/src/styles/chat-layout.css
@@ -161,6 +161,10 @@
 
 .scroll-to-bottom-button {
   position: absolute;
+  /* Above .prompt-rail (z-index 2). With the rail on the right edge its ticks
+     overlap this button, and a tick's hit target would otherwise swallow the
+     click that scrolls back to the latest turn. */
+  z-index: 3;
   bottom: 12px;
   right: 12px;
   width: 32px;
diff --git a/packages/kilo-vscode/webview-ui/src/styles/prompt-rail.css b/packages/kilo-vscode/webview-ui/src/styles/prompt-rail.css
index 0ae3e51eaad..78c65a69ea3 100644
--- a/packages/kilo-vscode/webview-ui/src/styles/prompt-rail.css
+++ b/packages/kilo-vscode/webview-ui/src/styles/prompt-rail.css
@@ -13,12 +13,26 @@
      starting a drag. */
   --prompt-rail-edge: 8px;
 
+  /* The transcript reserves a scrollbar gutter on its inline-end side, which is
+     physically right under LTR and physically left under RTL. Only the rail
+     sharing that side has to clear the scrollbar; the opposite side keeps the
+     bare splitter gutter so the default left rail is unchanged. */
+  --prompt-rail-left: var(--prompt-rail-edge);
+  --prompt-rail-right: calc(var(--prompt-rail-edge) + var(--chat-scrollbar-width, 10px));
+
   position: absolute;
   /* Against the panel edge rather than tracking the readable lane: on a wide
      editor tab the lane is centered, so a lane-hugging rail would sit right
      next to the prose the pointer travels over and open on the way past. The
-     far edge is somewhere the pointer only goes deliberately. */
-  inset-inline-start: var(--prompt-rail-edge);
+     far edge is somewhere the pointer only goes deliberately.
+
+     Physical left/right rather than logical insets: the setting is labelled
+     Left and Right, and place() anchors the hover card with physical
+     getBoundingClientRect/innerWidth math. A logical inset would silently flip
+     the rail under RTL without flipping that math, which pushes the card
+     off-screen. */
+  left: var(--prompt-rail-left);
+  right: auto;
   top: 0;
   bottom: 0;
   width: var(--prompt-rail-width);
@@ -40,15 +54,26 @@
   opacity: 1;
 }
 
+/* Swaps which physical side carries the scrollbar allowance. */
+.prompt-rail:dir(rtl) {
+  --prompt-rail-left: calc(var(--prompt-rail-edge) + var(--chat-scrollbar-width, 10px));
+  --prompt-rail-right: var(--prompt-rail-edge);
+}
+
 .prompt-rail[data-position="right"] {
-  inset-inline-start: auto;
-  inset-inline-end: var(--prompt-rail-edge);
+  left: auto;
+  right: var(--prompt-rail-right);
 }
 
 .prompt-rail-tick {
   pointer-events: auto;
   display: flex;
   align-items: center;
+  /* A tick is a decorative hairline with an aria-label, never text, so it
+     aligns physically: this row's flex-start would otherwise follow the text
+     direction and pull the line to the far side of the column under RTL,
+     against the physical transform-origin below. */
+  direction: ltr;
   justify-content: flex-start;
   height: var(--prompt-rail-step);
   min-height: 4px;