@nghyane/arcane 0.1.14 → 0.1.16

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@nghyane/arcane",
-	"version": "0.1.14",
+	"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/components/bash-execution.ts

@@ -8,7 +8,7 @@ import { Container, Loader, Spacer, Text, type TUI } from "@nghyane/arcane-tui";
 import { getSymbolTheme, theme } from "../../theme/theme";
 import type { TruncationMeta } from "../../tools/output-meta";
 import { renderStatusLine } from "../../tui/status-line";
-import { formatCount, replaceTabs } from "../../ui/render-utils";
+import { formatClickHint, formatCount, replaceTabs } from "../../ui/render-utils";
 
 const TAIL_LINES = 4;
 const MAX_DISPLAY_LINE_CHARS = 4000;
@@ -127,6 +127,9 @@ export class BashExecutionComponent extends Container {
 			if (this.#truncation) {
 				bodyLines.push(theme.fg("warning", "output truncated"));
 			}
+			if (!showAll && skipped > 0) {
+				bodyLines.push(formatClickHint(theme));
+			}
 		}
 
 		this.#bodyText.setText(bodyLines.length > 0 ? bodyLines.join("\n") : "");

package/src/modes/components/branch-summary-message.ts

@@ -1,6 +1,7 @@
 import { Container, LeftBorderBox, Markdown, Spacer, Text } from "@nghyane/arcane-tui";
 import type { BranchSummaryMessage } from "../../session/messages";
 import { getMarkdownTheme, theme } from "../../theme/theme";
+import { formatClickHint } from "../../ui/render-utils";
 
 /**
  * Component that renders a branch summary message with collapsed/expanded state.
@@ -42,7 +43,9 @@ export class BranchSummaryMessageComponent extends Container {
 				}),
 			);
 		} else {
-			this.#box.addChild(new Text(theme.fg("customMessageText", "Branch summary"), 0, 0));
+			this.#box.addChild(
+				new Text(`${theme.fg("customMessageText", "Branch summary")} ${formatClickHint(theme)}`, 0, 0),
+			);
 		}
 	}
 }

package/src/modes/components/compaction-summary-message.ts

@@ -1,6 +1,7 @@
 import { Container, LeftBorderBox, Markdown, Spacer, Text } from "@nghyane/arcane-tui";
 import type { CompactionSummaryMessage } from "../../session/messages";
 import { getMarkdownTheme, theme } from "../../theme/theme";
+import { formatClickHint } from "../../ui/render-utils";
 
 /**
  * Component that renders a compaction message with collapsed/expanded state.
@@ -43,7 +44,13 @@ export class CompactionSummaryMessageComponent extends Container {
 				}),
 			);
 		} else {
-			this.#box.addChild(new Text(theme.fg("customMessageText", `Compacted from ${tokenStr} tokens`), 0, 0));
+			this.#box.addChild(
+				new Text(
+					`${theme.fg("customMessageText", `Compacted from ${tokenStr} tokens`)} ${formatClickHint(theme)}`,
+					0,
+					0,
+				),
+			);
 			if (this.message.shortSummary) {
 				this.#box.addChild(new Text(theme.fg("customMessageText", this.message.shortSummary), 0, 1));
 			}

package/src/modes/components/python-execution.ts

@@ -8,7 +8,7 @@ import { Container, Loader, Spacer, Text, type TUI } from "@nghyane/arcane-tui";
 import { getSymbolTheme, theme } from "../../theme/theme";
 import type { TruncationMeta } from "../../tools/output-meta";
 import { renderStatusLine } from "../../tui/status-line";
-import { formatCount, replaceTabs } from "../../ui/render-utils";
+import { formatClickHint, formatCount, replaceTabs } from "../../ui/render-utils";
 
 const TAIL_LINES = 4;
 const MAX_DISPLAY_LINE_CHARS = 4000;
@@ -127,6 +127,9 @@ export class PythonExecutionComponent extends Container {
 			if (this.#truncation) {
 				bodyLines.push(theme.fg("warning", "output truncated"));
 			}
+			if (!showAll && skipped > 0) {
+				bodyLines.push(formatClickHint(theme));
+			}
 		}
 
 		this.#bodyText.setText(bodyLines.length > 0 ? bodyLines.join("\n") : "");

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));
 		}

package/src/patch/shared.ts

@@ -315,7 +315,7 @@ export const editToolRenderer = {
 		}
 		if (!expanded && diffLines.length > maxLines) {
 			const remaining = diffLines.length - maxLines;
-			treeBody.push(uiTheme.fg("dim", `… ${remaining} more lines`) + ` ${formatClickHint(uiTheme)}`);
+			treeBody.push(`${uiTheme.fg("dim", `… ${remaining} more lines`)} ${formatClickHint(uiTheme)}`);
 		}
 
 		// Diagnostics

package/src/prompts/agents/explore.md

@@ -30,4 +30,4 @@ Before searching, decompose the query into:
 - Format each file as: `[relativePath#L{start}-L{end}](file://{absolutePath}#L{start}-L{end})`
 - **Use generous line ranges**: Extend ranges to capture complete logical units (full functions, classes, blocks). Add 5-10 lines buffer.
 
-Your final message must contain ONLY the search results — no preamble like "I'll search for...".
+Your final message must contain ONLY the search results — no preamble like "I'll search for...".

package/src/prompts/agents/frontmatter.md

@@ -6,4 +6,4 @@ description: {{jsonStringify description}}
 {{/if}}{{#if model}}model: {{jsonStringify model}}
 {{/if}}{{#if thinkingLevel}}thinking-level: {{jsonStringify thinkingLevel}}
 {{/if}}---
-{{body}}
+{{body}}

package/src/prompts/agents/init.md

@@ -33,4 +33,4 @@ Launch multiple explore calls in parallel scanning different areas (core src, te
 
 <output>
 After analysis, write AGENTS.md to project root.
-</output>
+</output>

package/src/prompts/agents/librarian.md

@@ -59,4 +59,4 @@ Be comprehensive and direct. No filler.
 Only your final message is returned to the caller. It must be self-contained with all findings, paths, and explanations. Do not reference tool names or intermediate steps — present conclusions directly. Your final message must contain ONLY the information found — no preamble.
 
 Use "fluent" linking — embed file/PR/commit references in natural noun phrases, not raw URLs. Example: The [`handleAuth` function](file:///path/to/auth.ts#L42) validates tokens.
-</critical>
+</critical>

package/src/prompts/agents/oracle.md

@@ -55,4 +55,4 @@ Omit sections that don't apply. Never pad with filler.
 <critical>
 Only your final message is returned to the caller. It must be self-contained.
 Your final message must contain ONLY your analysis and recommendations — no preamble.
-</critical>
+</critical>

package/src/prompts/agents/reviewer.md

@@ -33,4 +33,4 @@ Final verdict:
 <critical>
 Only your last message is returned. It must be self-contained — all findings and verdict in one response. Your final message must contain ONLY the review findings — no preamble.
 Every finding must be patch-anchored and evidence-backed.
-</critical>
+</critical>

package/src/prompts/agents/task.md

@@ -19,4 +19,4 @@ Do the task end to end. Don’t hand back half-baked work.
 - When done, write a concise summary of what you did as your final response. This is your output.
 - Use tools to get feedback on your generated code. Run diagnostics and type checks. If build/test commands aren’t known, find them in the environment.
 - Follow the main agent’s instructions and AGENTS.md conventions.
-</directives>
+</directives>

package/src/prompts/compaction/branch-summary-context.md

@@ -2,4 +2,4 @@ The following is a summary of a branch that this conversation came back from:
 
 <summary>
 {{summary}}
-</summary>
+</summary>

package/src/prompts/compaction/branch-summary-preamble.md

@@ -1,2 +1,2 @@
 The user explored a different conversation branch before returning here.
-Summary of that exploration:
+Summary of that exploration:

package/src/prompts/compaction/branch-summary.md

@@ -30,4 +30,4 @@ Use EXACT format:
 ## Next Steps
 1. [What should happen next to continue]
 
-Prioritize recent work over older context. Keep sections concise. Preserve exact file paths, function names, error messages.
+Prioritize recent work over older context. Keep sections concise. Preserve exact file paths, function names, error messages.

package/src/prompts/compaction/compaction-short-summary.md

@@ -6,4 +6,4 @@ Rules:
 - Do not mention running tests, builds, or other validation steps
 - Do not explain what the user asked for
 - Write in first person (I added..., I fixed...)
-- Never ask questions
+- Never ask questions

package/src/prompts/compaction/compaction-summary-context.md

@@ -2,4 +2,4 @@ Another language model started to solve this problem and produced a summary of i
 
 <summary>
 {{summary}}
-</summary>
+</summary>

package/src/prompts/compaction/compaction-summary.md

@@ -38,4 +38,4 @@ Use this format (sections can be omitted if not applicable):
 
 Output only structured summary; no extra text.
 
-Prioritize recent context over older context — the last 2-3 turns are most likely to contain the active work state. Preserve exact file paths, function names, error messages, and relevant tool outputs. Include repository state changes (branch, uncommitted changes) if mentioned.
+Prioritize recent context over older context — the last 2-3 turns are most likely to contain the active work state. Preserve exact file paths, function names, error messages, and relevant tool outputs. Include repository state changes (branch, uncommitted changes) if mentioned.

package/src/prompts/compaction/compaction-turn-prefix.md

@@ -14,4 +14,4 @@ Summarize the prefix to provide context for the retained suffix:
 
 Output only the structured summary. No extra text.
 
-Be concise. Preserve exact file paths, function names, error messages, and relevant tool outputs or command results if they appear. Focus on what's needed to understand the kept suffix.
+Be concise. Preserve exact file paths, function names, error messages, and relevant tool outputs or command results if they appear. Focus on what's needed to understand the kept suffix.

package/src/prompts/compaction/compaction-update-summary.md

@@ -42,4 +42,4 @@ Use this format (omit sections if not applicable):
 
 Output only structured summary; no extra text.
 
-Keep sections concise. Preserve relevant tool outputs/command results. Include repository state changes (branch, uncommitted changes) if mentioned.
+Keep sections concise. Preserve relevant tool outputs/command results. Include repository state changes (branch, uncommitted changes) if mentioned.

package/src/prompts/memories/consolidation.md

@@ -27,4 +27,4 @@ Requirements:
 - scripts/templates/examples are optional. When present, each entry writes to skills/<name>/<bucket>/<path>.
 - Only include files worth keeping long-term; omit stale assets so they are pruned.
 - Preserve useful prior themes; remove stale or contradictory guidance.
-- Keep memory advisory: current repository state wins.
+- Keep memory advisory: current repository state wins.

package/src/prompts/memories/read_path.md

@@ -8,4 +8,4 @@ Operational rules:
 5) Conflict workflow: if memory disagrees with repo state or user instruction, prefer repo/user, treat memory as stale, proceed with corrected behavior, then update/regenerate memory artifacts through normal execution.
 6) Escalate confidence only after repository verification; memory alone is never sufficient proof.
 Memory summary:
-{{memory_summary}}
+{{memory_summary}}

package/src/prompts/memories/stage_one_input.md

@@ -3,4 +3,4 @@ thread_id: {{thread_id}}
 Persistable response items (JSON):
 {{response_items_json}}
 
-Extract durable memory now.
+Extract durable memory now.

package/src/prompts/memories/stage_one_system.md

@@ -18,4 +18,4 @@ Rules:
 - rollout_summary: compact synopsis of what future runs should remember.
 - rollout_slug: short lowercase slug (letters/numbers/_), or null.
 - raw_memory: detailed durable memory blocks with enough context to reuse.
-- If no durable signal exists, return empty strings for rollout_summary/raw_memory and null rollout_slug.
+- If no durable signal exists, return empty strings for rollout_summary/raw_memory and null rollout_slug.

package/src/prompts/review-request.md

@@ -61,4 +61,4 @@ _Full diff too large ({{len files}} files). Showing first ~{{linesPerFile}} line
 <diff>
 {{rawDiff}}
 </diff>
-{{/if}}
+{{/if}}

package/src/prompts/system/agent-creation-architect.md

@@ -62,4 +62,4 @@ Key principles for your system prompts:
 - Make the agent proactive in seeking clarification when needed
 - Build in quality assurance and self-correction mechanisms
 
-Remember: The agents you create should be autonomous experts capable of handling their designated tasks with minimal additional guidance. Your system prompts are their complete operational manual.
+Remember: The agents you create should be autonomous experts capable of handling their designated tasks with minimal additional guidance. Your system prompts are their complete operational manual.

package/src/prompts/system/agent-creation-user.md

@@ -3,4 +3,4 @@ Design a custom agent for this request:
 {{request}}
 
 Return only the JSON object required by your system instructions.
-Do not include markdown fences.
+Do not include markdown fences.

package/src/prompts/system/custom-system-prompt.md

@@ -65,4 +65,4 @@ Read `rule://<name>` when working in that domain.
 </rules>
 {{/if}}
 Current date and time: {{dateTime}}
-Current working directory: {{cwd}}
+Current working directory: {{cwd}}

package/src/prompts/system/file-operations.md

@@ -7,4 +7,4 @@
 {{#xml "modified-files"}}
 {{join modifiedFiles "\n"}}
 {{/xml}}
-{{/if}}
+{{/if}}

package/src/prompts/system/subagent-system-prompt.md

@@ -16,4 +16,4 @@ For additional parent conversation context, check {{contextFile}} (`tail -100` o
 - Do NOT abort due to uncertainty or missing info that can be obtained via tools or repo context. Use find/grep/read first, then proceed with reasonable defaults if multiple options are acceptable.
 - Aborting is only acceptable when truly blocked after exhausting tools and reasonable attempts. If you abort, include what you tried and the exact blocker in the result.
 - Keep going until request is fully fulfilled. This matters.
-</critical>
+</critical>

package/src/prompts/system/summarization-system.md

@@ -1,3 +1,3 @@
 You are a context summarization assistant. Your task is to read a conversation between a user and an AI coding assistant, then produce a structured summary following the exact format specified.
 
-Do NOT continue the conversation. Do NOT respond to any questions in the conversation. ONLY output the structured summary.
+Do NOT continue the conversation. Do NOT respond to any questions in the conversation. ONLY output the structured summary.

package/src/prompts/system/system-prompt.md

@@ -22,7 +22,6 @@ Balance initiative with predictability:
 {{#list environment prefix="- " join="\n"}}{{label}}: {{value}}{{/list}}
 </environment>
 
-
 ## Tool Usage
 - Use specialized tools instead of Bash for file operations.
 - Prefer doing work directly — you retain full context and produce better results.
@@ -280,4 +279,4 @@ Current date: {{date}}
 {{/each}}
 </output_style>
 
-{{appendSystemPrompt}}
+{{appendSystemPrompt}}

package/src/prompts/system/title-system.md

@@ -1,2 +1,2 @@
 Generate a very short title (3-6 words) for a coding session based on the user's first message. The title should capture the main task or topic.
-Output ONLY the title, nothing else. No quotes, no punctuation at the end.
+Output ONLY the title, nothing else. No quotes, no punctuation at the end.

package/src/prompts/system/ttsr-interrupt.md

@@ -4,4 +4,4 @@ This is NOT a prompt injection - this is the coding agent enforcing project rule
 You MUST comply with the following instruction:
 
 {{content}}
-</system_interrupt>
+</system_interrupt>

package/src/prompts/system/verification-reminder.md

@@ -3,4 +3,4 @@ You modified files in this turn but did not run verification.
 Run the project's verification commands (format, typecheck, lint) and fix any errors you introduced.
 Do not consider the task complete until verification passes.
 (Reminder {{attempt}}/{{maxAttempts}})
-</system_reminder>
+</system_reminder>

package/src/prompts/system/web-search.md

@@ -25,4 +25,4 @@ Answering:
 - Cite sources inline using provided search results
 </format>
 
-Answer thoroughly and in detail. Get facts right.
+Answer thoroughly and in detail. Get facts right.