@nghyane/arcane 0.1.15 → 0.1.16

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@nghyane/arcane",
-	"version": "0.1.15",
+	"version": "0.1.16",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/nghyane/arcane",
 	"author": "Can Bölük",

package/src/config/keybindings.ts

@@ -116,10 +116,12 @@ function isAppAction(action: string): action is AppAction {
 /**
  * Key hint formatting utilities for UI labels.
  */
+const IS_MACOS = process.platform === "darwin";
+
 const MODIFIER_LABELS: Record<string, string> = {
-	ctrl: "Ctrl",
-	shift: "Shift",
-	alt: "Alt",
+	ctrl: IS_MACOS ? "⌃" : "Ctrl",
+	shift: IS_MACOS ? "⇧" : "Shift",
+	alt: IS_MACOS ? "⌥" : "Alt",
 };
 
 const KEY_LABELS: Record<string, string> = {
@@ -154,7 +156,8 @@ function formatKeyPart(part: string): string {
 }
 
 export function formatKeyHint(key: KeyId): string {
-	return key.split("+").map(formatKeyPart).join("+");
+	const parts = key.split("+").map(formatKeyPart);
+	return IS_MACOS ? parts.join("") : parts.join("+");
 }
 
 export function formatKeyHints(keys: KeyId | KeyId[]): string {
@@ -253,13 +256,12 @@ export class KeybindingsManager {
 	}
 
 	/**
-	 * Get display string for an action.
+	 * Get display string for an action, formatted for the current platform.
 	 */
 	getDisplayString(action: AppAction): string {
 		const keys = this.getKeys(action);
 		if (keys.length === 0) return "";
-		if (keys.length === 1) return keys[0]!;
-		return keys.join("/");
+		return formatKeyHints(keys);
 	}
 
 	/**

package/src/modes/controllers/command-controller.ts

@@ -14,6 +14,7 @@ import { Snowflake } from "@nghyane/arcane-utils";
 import { setProjectDir } from "@nghyane/arcane-utils/dirs";
 import { $ } from "bun";
 import { reset as resetCapabilities } from "../../capability";
+import { formatKeyHint, type KeyId } from "../../config/keybindings";
 import { loadCustomShare } from "../../export/custom-share";
 import type { CompactOptions } from "../../extensibility/extensions/types";
 import { getGatewayStatus } from "../../ipy/gateway-coordinator";
@@ -362,43 +363,44 @@ export class CommandController {
 	}
 
 	handleHotkeysCommand(): void {
-		const expandToolsKey = this.ctx.keybindings.getDisplayString("expandTools") || "Ctrl+O";
-		const sttKey = this.ctx.keybindings.getDisplayString("toggleSTT") || "Alt+H";
+		const k = (id: string) => formatKeyHint(id as KeyId);
+		const expandToolsKey = this.ctx.keybindings.getDisplayString("expandTools") || k("ctrl+o");
+		const sttKey = this.ctx.keybindings.getDisplayString("toggleSTT") || k("alt+h");
 		const hotkeys = `
 **Navigation**
 | Key | Action |
 |-----|--------|
 | \`Arrow keys\` | Move cursor / browse history (Up when empty) |
-| \`Option+Left/Right\` | Move by word |
-| \`Ctrl+A\` / \`Home\` / \`Cmd+Left\` | Start of line |
-| \`Ctrl+E\` / \`End\` / \`Cmd+Right\` | End of line |
+| \`${k("alt+left")}/${k("alt+right")}\` | Move by word |
+| \`${k("ctrl+a")}\` / \`Home\` | Start of line |
+| \`${k("ctrl+e")}\` / \`End\` | End of line |
 
 **Editing**
 | Key | Action |
 |-----|--------|
 | \`Enter\` | Send message |
-| \`Shift+Enter\` / \`Alt+Enter\` | New line |
-| \`Ctrl+W\` / \`Option+Backspace\` | Delete word backwards |
-| \`Ctrl+U\` | Delete to start of line |
-| \`Ctrl+K\` | Delete to end of line |
+| \`${k("shift+enter")}\` / \`${k("alt+enter")}\` | New line |
+| \`${k("ctrl+w")}\` / \`${k("alt+backspace")}\` | Delete word backwards |
+| \`${k("ctrl+u")}\` | Delete to start of line |
+| \`${k("ctrl+k")}\` | Delete to end of line |
 
 **Other**
 | Key | Action |
 |-----|--------|
 | \`Tab\` | Path completion / accept autocomplete |
 | \`Escape\` | Cancel autocomplete / abort streaming |
-| \`Ctrl+C\` | Clear editor (first) / exit (second) |
-| \`Ctrl+D\` | Exit (when editor is empty) |
-| \`Ctrl+Z\` | Suspend to background |
-| \`Shift+Tab\` | Cycle thinking level |
-| \`Ctrl+P\` | Cycle role models (slow/default/fast) |
-| \`Shift+Ctrl+P\` | Cycle role models (temporary) |
-| \`Alt+P\` | Select model (temporary) |
-| \`Ctrl+L\` | Select model (set roles) |
-| \`Ctrl+R\` | Search prompt history |
+| \`${k("ctrl+c")}\` | Clear editor (first) / exit (second) |
+| \`${k("ctrl+d")}\` | Exit (when editor is empty) |
+| \`${k("ctrl+z")}\` | Suspend to background |
+| \`${k("shift+tab")}\` | Cycle thinking level |
+| \`${k("ctrl+p")}\` | Cycle role models (slow/default/fast) |
+| \`${k("shift+ctrl+p")}\` | Cycle role models (temporary) |
+| \`${k("alt+p")}\` | Select model (temporary) |
+| \`${k("ctrl+l")}\` | Select model (set roles) |
+| \`${k("ctrl+r")}\` | Search prompt history |
 | \`${expandToolsKey}\` | Toggle tool output expansion |
-| \`Ctrl+T\` | Toggle todo list expansion |
-| \`Ctrl+G\` | Edit message in external editor |
+| \`${k("ctrl+t")}\` | Toggle todo list expansion |
+| \`${k("ctrl+g")}\` | Edit message in external editor |
 | \`${sttKey}\` | Toggle speech-to-text recording |
 | \`/\` | Slash commands |
 | \`!\` | Run bash command |

package/src/modes/utils/ui-helpers.ts

@@ -1,6 +1,7 @@
 import type { AgentMessage } from "@nghyane/arcane-agent";
 import type { AssistantMessage, Message } from "@nghyane/arcane-ai";
 import { Spacer, Text, TruncatedText } from "@nghyane/arcane-tui";
+import { formatKeyHint, type KeyId } from "../../config/keybindings";
 import { settings } from "../../config/settings";
 import { AssistantMessageComponent } from "../../modes/components/assistant-message";
 import { BashExecutionComponent } from "../../modes/components/bash-execution";
@@ -385,7 +386,7 @@ export class UiHelpers {
 				const queuedText = theme.fg("dim", `${entry.label}: ${entry.message}`);
 				this.ctx.pendingMessagesContainer.addChild(new TruncatedText(queuedText, 1, 0));
 			}
-			const dequeueKey = this.ctx.keybindings.getDisplayString("dequeue") || "Alt+Up";
+			const dequeueKey = this.ctx.keybindings.getDisplayString("dequeue") || formatKeyHint("alt+up" as KeyId);
 			const hintText = theme.fg("dim", `${theme.tree.hook} ${dequeueKey} to edit`);
 			this.ctx.pendingMessagesContainer.addChild(new TruncatedText(hintText, 1, 0));
 		}