@oh-my-pi/pi-coding-agent 12.12.3 → 12.14.0

package/CHANGELOG.md

@@ -2,6 +2,74 @@
 
 ## [Unreleased]
 
+## [12.14.0] - 2026-02-19
+
+### Added
+
+- Support for `docs://` internal URL protocol to access embedded documentation files (e.g., `docs://sdk.md`)
+- Added `generate-docs-index` npm script to automatically index and embed documentation files at build time
+- Support for executable tool files (.ts, .js, .sh, .bash, .py) in custom tools discovery alongside markdown files
+- Display streamed tool intent in working message during agent execution
+- Added `tools.intentTracing` setting to enable intent tracing, which asks the agent to describe the intent of each tool call before executing it
+- Support for file deletion in hashline edit mode via `delete: true` parameter
+- Support for file renaming/moving in hashline edit mode via `rename` parameter
+- Optional content-replace edit variant in hashline mode (enabled via `PI_HL_REPLACETXT=1` environment variable)
+- Support for grepping internal URLs (artifact://) by resolving them to their backing files
+
+### Changed
+
+- System prompt now identifies agent as operating inside Oh My Pi harness and instructs reading docs:// URLs for omp/pi topics
+- Tool discovery now accepts executable script extensions (.ts, .js, .sh, .bash, .py) in addition to .json and .md files
+- Updated bash and read tool documentation to reference `docs://` URL support
+- Hashline format separator changed from pipe (`|`) to colon (`:`) for improved readability (e.g., `LINE#ID:content` instead of `LINE#ID|content`)
+- Hashline hash representation changed from 4-character base36 to 2-character hexadecimal for more compact line references
+- Hashline edit API: renamed `delete` parameter to `rm` for consistency with standard file operations
+- Hashline edit API: renamed `rename` parameter to `mv` for consistency with standard file operations
+- Hashline edit API: content-replace operations now require explicit `op: "replaceText"` field to distinguish from other edit types
+- Hashline documentation terminology updated: references to 'anchors' replaced with 'tags' for clearer semantics
+- Intent tracing now uses `_intent` field name in tool schemas
+- Hashline edit API: renamed `set` operation to `target`/`new_content` for clearer semantics
+- Hashline edit API: renamed `set_range` operation to `first`/`last`/`new_content`
+- Hashline edit API: renamed `insert` operation fields from `body` to `inserted_lines` and made `inserted_lines` required non-empty
+- Hashline edit API: flattened `replace` operation to top-level fields (`old_text`, `new_text`, `all`) when enabled
+- Hashline edit validation now provides more specific error messages indicating which variant is expected
+
+### Fixed
+
+- Grep tool now properly handles internal URL resolution when searching artifact paths
+- Working message intent updates now fall back to tool execution events when streamed tool arguments omit the intent field
+
+## [12.13.0] - 2026-02-19
+
+### Breaking Changes
+
+- Removed automatic line relocation when hash references become stale; edits with mismatched line hashes now fail with an error instead of silently relocating to matching lines elsewhere in the file
+
+### Added
+
+- Added `ssh` command for managing SSH host configurations (add, list, remove)
+- Added `/ssh` slash command in interactive mode to manage SSH hosts with subcommands
+- Added support for SSH host configuration at project and user scopes (.omp/ssh.json and ~/.omp/agent/ssh.json)
+- Added `--host`, `--user`, `--port`, `--key`, `--desc`, `--compat`, and `--scope` flags for SSH host configuration
+- Added discovery of SSH hosts from project configuration files alongside manually configured hosts
+- Added NanoGPT as a login provider (`/login nanogpt`) with API key prompt flow linking to `https://nano-gpt.com/api` ([#111](https://github.com/can1357/oh-my-pi/issues/111))
+
+### Changed
+
+- Updated hashline reference format from `LINE:HASH` to `LINE#ID` throughout the codebase for improved clarity
+- Renamed hashline edit operations: `set_line` → `set`, `replace_lines` → `set_range`, `insert_after` → `insert` with support for `before` and `between` anchors
+- Changed hashline edit `body` field from string to array of strings for clearer multiline handling
+- Updated handlebars helpers: renamed `hashline` to `hlineref` and added `hlinefull` for formatted line output
+- Improved insert operation to support `before`, `after`, and `between` (both anchors) positioning modes
+- Made autocorrect heuristics (boundary echo stripping, indent restoration) conditional on `PI_HL_AUTOCORRECT` environment variable
+- Updated SSH host discovery to load from managed omp config paths (.omp/ssh.json and ~/.omp/agent/ssh.json) in addition to legacy root-level ssh.json and .ssh.json files
+- Improved terminal output handling in interactive bash sessions to ensure all queued writes complete before returning results
+
+### Fixed
+
+- Fixed insert-between operation to properly validate adjacent anchor lines and strip boundary echoes from both sides
+- Fixed terminal output handling to properly queue and serialize writes, preventing dropped or corrupted output in interactive bash sessions
+
 ## [12.12.1] - 2026-02-19
 
 ### Added
@@ -141,6 +209,7 @@
 - Refactored session directory naming to use single-dash format for home-relative paths and double-dash format for absolute paths, with automatic migration of legacy session directories on first access
 
 ## [12.8.2] - 2026-02-17
+
 ### Changed
 
 - Changed system environment context to use built-in `os` values for distro, kernel, and CPU model instead of native system-info data
@@ -153,11 +222,14 @@
 ## [12.8.0] - 2026-02-16
 
 ### Changed
+
 - Improved `/changelog` performance by displaying only the most recent 3 versions by default, with a `--full` flag for the complete history ([#85](https://github.com/can1357/oh-my-pi/pull/85) by [@tctev](https://github.com/tctev))
 - Centralized builtin slash command definitions and handlers into a shared registry, replacing the large input-controller if-chain dispatch
 
 ## [12.7.0] - 2026-02-16
+
 ### Added
+
 - Added abort signal support to LSP file operations (`ensureFileOpen`, `refreshFile`) for cancellable file synchronization
 - Added abort signal propagation through LSP request handlers (definition, references, hover, symbols, rename) enabling operation cancellation
 - Added `shouldBypassAutocompleteOnEscape` callback to custom editor for context-aware escape key handling during active operations
@@ -172,7 +244,9 @@
 - Added secret obfuscation: env vars matching secret patterns and `secrets.json` entries are replaced with placeholders before sending to LLM providers, deobfuscated in tool call arguments
 - Added `secrets.enabled` setting to toggle secret obfuscation
 - Added full regex literal support for `secrets.json` entries (`"/pattern/flags"` syntax with escaped `/` handling, automatic `g` flag enforcement)
+
 ### Changed
+
 - Changed context promotion to trigger on context overflow instead of a configurable threshold, promoting to a larger model before attempting compaction
 - Changed context promotion behavior to retry immediately on the promoted model without compacting, providing faster recovery from context limits
 - Changed default grep context lines from 1 before/3 after to 0 before/0 after for more focused search results
@@ -187,20 +261,25 @@
 - Updated web search provider priority order to include Brave (Exa → Brave → Jina → Perplexity → Anthropic → Gemini → Codex → Z.AI)
 - Extended recency filter support to Brave provider alongside Perplexity
 - Changed GitHub issue comment fetching to use paginated API requests with 100 comments per page instead of single request with 50-comment limit
+
 ### Removed
 
 - Removed `contextPromotion.thresholdPercent` setting as context promotion now triggers only on overflow
 
 ### Fixed
+
 - Fixed LSP operations to properly respect abort signals and throw `ToolAbortError` when cancelled
 - Fixed workspace diagnostics process cleanup to remove abort event listeners in finally block
 - Fixed PTY-backed bash execution to enforce timeout completion when detached child processes keep the PTY stream open ([#88](https://github.com/can1357/oh-my-pi/issues/88))
+
 ## [12.5.1] - 2026-02-15
+
 ### Added
 
 - Added `repeatToolDescriptions` setting to render full tool descriptions in the system prompt instead of a tool name list
 
 ## [12.5.0] - 2026-02-15
+
 ### Breaking Changes
 
 - Replaced `theme` setting with `theme.dark` and `theme.light` (auto-migrated)
@@ -251,6 +330,7 @@
 - Sanitized debug log display to strip control codes, normalize tabs, and trim width
 
 ## [12.4.0] - 2026-02-14
+
 ### Changed
 
 - Moved `sanitizeText` function from `@oh-my-pi/pi-utils` to `@oh-my-pi/pi-natives` for better code organization
@@ -266,6 +346,7 @@
 - Fixed Cloudflare returning corrupted bytes when compression is negotiated in web scraper requests
 
 ## [12.3.0] - 2026-02-14
+
 ### Added
 
 - Added autonomous memory extraction and consolidation system with configurable settings
@@ -311,6 +392,7 @@
 - Fixed fetch tool to preserve actual response metadata (finalUrl, contentType) instead of defaults when requests fail
 
 ||||||| parent of a70a34c8b (fix(coding-agent/debug): Sanitized debug log rendering)
+
 ## [12.1.0] - 2026-02-13
 
 ### Added
@@ -362,6 +444,7 @@
 - Removed @types/jsdom dependency
 
 ## [11.14.1] - 2026-02-12
+
 ### Changed
 
 - Improved Bun binary detection to check `Bun.env.PI_COMPILED` environment variable
@@ -373,6 +456,7 @@
 - Fixed Bun update process to properly handle version pinning and report installation mismatches
 
 ## [11.14.0] - 2026-02-12
+
 ### Added
 
 - Added SwiftLint linter client with JSON reporter support for Swift file linting
@@ -425,6 +509,7 @@
 - Refactored browser/file opening across multiple modules to use unified `openPath` utility for improved maintainability
 
 ## [11.12.0] - 2026-02-11
+
 ### Added
 
 - Added `resolveFileDisplayMode` utility to centralize file display mode resolution across tools (read, grep, file mentions)
@@ -513,6 +598,7 @@
 - Refactored hash line formatting to use async `streamHashLinesFromLines` for better performance
 
 ## [11.10.3] - 2026-02-10
+
 ### Added
 
 - Exported `./patch/*` subpath for direct access to patch utilities
@@ -538,6 +624,7 @@
 - Removed AggregateError unwrapping from console.warn in CLI initialization
 
 ## [11.10.1] - 2026-02-10
+
 ### Changed
 
 - Migrated CLI framework from oclif to lightweight pi-utils CLI runner
@@ -552,6 +639,7 @@
 - Removed custom oclif help renderer (oclif-help.ts)
 
 ## [11.10.0] - 2026-02-10
+
 ### Breaking Changes
 
 - Changed `HashlineEdit.src` from string format (e.g., `"5:ab"`, `"5:ab..9:ef"`) to structured `SrcSpec` object with discriminated union types (`{ kind: "single", ref: "..." }`, `{ kind: "range", start: "...", end: "..." }`, etc.)
@@ -702,6 +790,7 @@
 - Improved bash tool output draining after foreground completion to reduce tail output truncation
 
 ## [11.8.0] - 2026-02-10
+
 ### Added
 
 - Added `ctx.reload()` method to extension command context to reload extensions, skills, prompts, and themes from disk
@@ -724,6 +813,7 @@
 - Fixed archive extraction error handling to provide clear error messages on failure
 
 ## [11.7.0] - 2026-02-07
+
 ### Changed
 
 - Enhanced error messages for failed Python cells to include full combined output context instead of just the error message
@@ -735,6 +825,7 @@
 - Fixed tab character rendering in Python tool output display to properly format whitespace in cell output and status events
 
 ## [11.6.1] - 2026-02-07
+
 ### Fixed
 
 - Fixed potential crash when rendering results with undefined details.results
@@ -783,6 +874,7 @@
 - Removed ability to save screenshots to custom paths or artifacts directory
 
 ## [11.4.1] - 2026-02-06
+
 ### Fixed
 
 - Fixed tab character display in error messages and bash tool output by properly replacing tabs with spaces

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "12.12.3",
+	"version": "12.14.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"bin": {
@@ -78,18 +78,19 @@
 	"scripts": {
 		"check": "tsgo -p tsconfig.json",
 		"format-prompts": "bun scripts/format-prompts.ts",
+		"generate-docs-index": "bun scripts/generate-docs-index.ts",
 		"build:binary": "cd ../.. && bun --cwd=packages/stats scripts/generate-client-bundle.ts && bun --cwd=packages/natives run embed:native && bun build --compile --define PI_COMPILED=true --root . ./packages/coding-agent/src/cli.ts --outfile packages/coding-agent/dist/omp && bun --cwd=packages/natives run embed:native --reset && bun --cwd=packages/stats scripts/generate-client-bundle.ts --reset",
 		"generate-template": "bun scripts/generate-template.ts",
 		"test": "bun test"
 	},
 	"dependencies": {
 		"@mozilla/readability": "0.6.0",
-		"@oh-my-pi/omp-stats": "12.12.3",
-		"@oh-my-pi/pi-agent-core": "12.12.3",
-		"@oh-my-pi/pi-ai": "12.12.3",
-		"@oh-my-pi/pi-natives": "12.12.3",
-		"@oh-my-pi/pi-tui": "12.12.3",
-		"@oh-my-pi/pi-utils": "12.12.3",
+		"@oh-my-pi/omp-stats": "12.14.0",
+		"@oh-my-pi/pi-agent-core": "12.14.0",
+		"@oh-my-pi/pi-ai": "12.14.0",
+		"@oh-my-pi/pi-natives": "12.14.0",
+		"@oh-my-pi/pi-tui": "12.14.0",
+		"@oh-my-pi/pi-utils": "12.14.0",
 		"@sinclair/typebox": "^0.34.48",
 		"@xterm/headless": "^6.0.0",
 		"ajv": "^8.18.0",

package/scripts/generate-docs-index.ts

@@ -0,0 +1,56 @@
+#!/usr/bin/env bun
+
+import { Glob } from "bun";
+import * as path from "node:path";
+
+const docsDir = new URL("../../../docs/", import.meta.url).pathname;
+const outputPath = new URL("../src/internal-urls/docs-index.generated.ts", import.meta.url).pathname;
+const importBase = "../../../../docs";
+
+function toIdentifier(relativePath: string): string {
+	const withoutExt = relativePath.replace(/\.md$/i, "");
+	const parts = withoutExt
+		.split(/[^a-zA-Z0-9]+/)
+		.filter(Boolean)
+		.map((part, index) => {
+			if (index === 0) {
+				return part.toLowerCase();
+			}
+			return part.charAt(0).toUpperCase() + part.slice(1).toLowerCase();
+		});
+
+	const base = parts.length > 0 ? parts.join("") : "doc";
+	const safeBase = /^[0-9]/.test(base) ? `doc${base}` : base;
+	return `${safeBase}Md`;
+}
+
+const glob = new Glob("**/*.md");
+const entries: string[] = [];
+for await (const relativePath of glob.scan(docsDir)) {
+	entries.push(relativePath.split(path.sep).join("/"));
+}
+entries.sort();
+
+const usedIdentifiers = new Set<string>();
+const docs = entries.map((relativePath) => {
+	let identifier = toIdentifier(relativePath);
+	let suffix = 2;
+	while (usedIdentifiers.has(identifier)) {
+		identifier = `${toIdentifier(relativePath)}${suffix}`;
+		suffix++;
+	}
+	usedIdentifiers.add(identifier);
+	return { relativePath, identifier };
+});
+docs.sort((a, b) => a.identifier.localeCompare(b.identifier) || a.relativePath.localeCompare(b.relativePath));
+
+const imports = docs
+	.map(({ relativePath, identifier }) => `import ${identifier} from "${importBase}/${relativePath}" with { type: "text" };`)
+	.join("\n");
+
+const mapEntries = docs.map(({ relativePath, identifier }) => `\t"${relativePath}": ${identifier},`).join("\n");
+
+const output = `// Auto-generated by scripts/generate-docs-index.ts - DO NOT EDIT\n\n${imports}\n\nexport const EMBEDDED_DOCS: Readonly<Record<string, string>> = {\n${mapEntries}\n};\n\nexport const EMBEDDED_DOC_FILENAMES = Object.keys(EMBEDDED_DOCS).sort();\n`;
+
+await Bun.write(outputPath, output);
+console.log(`Generated ${path.relative(process.cwd(), outputPath)} (${docs.length} docs)`);

package/src/cli/ssh-cli.ts

@@ -0,0 +1,179 @@
+/**
+ * SSH CLI command handlers.
+ *
+ * Handles `omp ssh <command>` subcommands for SSH host configuration management.
+ */
+
+import { getSSHConfigPath } from "@oh-my-pi/pi-utils/dirs";
+import chalk from "chalk";
+import { addSSHHost, readSSHConfigFile, removeSSHHost, type SSHHostConfig } from "../ssh/config-writer";
+
+// =============================================================================
+// Types
+// =============================================================================
+
+export type SSHAction = "add" | "remove" | "list";
+
+export interface SSHCommandArgs {
+	action: SSHAction;
+	args: string[];
+	flags: {
+		json?: boolean;
+		host?: string;
+		user?: string;
+		port?: string;
+		key?: string;
+		desc?: string;
+		compat?: boolean;
+		scope?: "project" | "user";
+	};
+}
+
+// =============================================================================
+// Main dispatcher
+// =============================================================================
+
+export async function runSSHCommand(cmd: SSHCommandArgs): Promise<void> {
+	switch (cmd.action) {
+		case "add":
+			await handleAdd(cmd);
+			break;
+		case "remove":
+			await handleRemove(cmd);
+			break;
+		case "list":
+			await handleList(cmd);
+			break;
+		default:
+			process.stdout.write(chalk.red(`Unknown action: ${cmd.action}\n`));
+			process.stdout.write(`Valid actions: add, remove, list\n`);
+			process.exitCode = 1;
+	}
+}
+
+// =============================================================================
+// Handlers
+// =============================================================================
+
+async function handleAdd(cmd: SSHCommandArgs): Promise<void> {
+	const name = cmd.args[0];
+	if (!name) {
+		process.stdout.write(chalk.red("Error: Host name required\n"));
+		process.stdout.write(
+			chalk.dim("Usage: omp ssh add <name> --host <address> [--user <user>] [--port <port>] [--key <path>]\n"),
+		);
+		process.exitCode = 1;
+		return;
+	}
+
+	const host = cmd.flags.host;
+	if (!host) {
+		process.stdout.write(chalk.red("Error: --host is required\n"));
+		process.stdout.write(chalk.dim("Usage: omp ssh add <name> --host <address>\n"));
+		process.exitCode = 1;
+		return;
+	}
+
+	// Validate port if provided
+	if (cmd.flags.port !== undefined) {
+		const port = Number.parseInt(cmd.flags.port, 10);
+		if (Number.isNaN(port) || port < 1 || port > 65535) {
+			process.stdout.write(chalk.red("Error: Port must be an integer between 1 and 65535\n"));
+			process.exitCode = 1;
+			return;
+		}
+	}
+
+	const hostConfig: SSHHostConfig = { host };
+	if (cmd.flags.user) hostConfig.username = cmd.flags.user;
+	if (cmd.flags.port) hostConfig.port = Number.parseInt(cmd.flags.port, 10);
+	if (cmd.flags.key) hostConfig.keyPath = cmd.flags.key;
+	if (cmd.flags.desc) hostConfig.description = cmd.flags.desc;
+	if (cmd.flags.compat) hostConfig.compat = true;
+
+	const scope = cmd.flags.scope ?? "project";
+	const filePath = getSSHConfigPath(scope);
+
+	try {
+		await addSSHHost(filePath, name, hostConfig);
+		process.stdout.write(chalk.green(`Added SSH host "${name}" to ${scope} config\n`));
+	} catch (err) {
+		process.stdout.write(chalk.red(`Error: ${err instanceof Error ? err.message : String(err)}\n`));
+		process.exitCode = 1;
+	}
+}
+
+async function handleRemove(cmd: SSHCommandArgs): Promise<void> {
+	const name = cmd.args[0];
+	if (!name) {
+		process.stdout.write(chalk.red("Error: Host name required\n"));
+		process.stdout.write(chalk.dim("Usage: omp ssh remove <name> [--scope project|user]\n"));
+		process.exitCode = 1;
+		return;
+	}
+
+	const scope = cmd.flags.scope ?? "project";
+	const filePath = getSSHConfigPath(scope);
+
+	try {
+		await removeSSHHost(filePath, name);
+		process.stdout.write(chalk.green(`Removed SSH host "${name}" from ${scope} config\n`));
+	} catch (err) {
+		process.stdout.write(chalk.red(`Error: ${err instanceof Error ? err.message : String(err)}\n`));
+		process.exitCode = 1;
+	}
+}
+
+async function handleList(cmd: SSHCommandArgs): Promise<void> {
+	const projectPath = getSSHConfigPath("project");
+	const userPath = getSSHConfigPath("user");
+
+	const [projectConfig, userConfig] = await Promise.all([readSSHConfigFile(projectPath), readSSHConfigFile(userPath)]);
+
+	const projectHosts = projectConfig.hosts ?? {};
+	const userHosts = userConfig.hosts ?? {};
+
+	if (cmd.flags.json) {
+		process.stdout.write(JSON.stringify({ project: projectHosts, user: userHosts }, null, 2));
+		process.stdout.write("\n");
+		return;
+	}
+
+	const hasProject = Object.keys(projectHosts).length > 0;
+	const hasUser = Object.keys(userHosts).length > 0;
+
+	if (!hasProject && !hasUser) {
+		process.stdout.write(chalk.dim("No SSH hosts configured\n"));
+		process.stdout.write(chalk.dim("Add one with: omp ssh add <name> --host <address>\n"));
+		return;
+	}
+
+	if (hasProject) {
+		process.stdout.write(chalk.bold("Project SSH Hosts (.omp/ssh.json):\n"));
+		printHosts(projectHosts);
+	}
+
+	if (hasProject && hasUser) {
+		process.stdout.write("\n");
+	}
+
+	if (hasUser) {
+		process.stdout.write(chalk.bold("User SSH Hosts (~/.omp/agent/ssh.json):\n"));
+		printHosts(userHosts);
+	}
+}
+
+// =============================================================================
+// Helpers
+// =============================================================================
+
+function printHosts(hosts: Record<string, SSHHostConfig>): void {
+	for (const [name, config] of Object.entries(hosts)) {
+		const parts = [chalk.cyan(name), config.host];
+		if (config.username) parts.push(chalk.dim(config.username));
+		if (config.port && config.port !== 22) parts.push(chalk.dim(`port:${config.port}`));
+		if (config.keyPath) parts.push(chalk.dim(config.keyPath));
+		if (config.description) parts.push(chalk.dim(`- ${config.description}`));
+		process.stdout.write(`  ${parts.join("  ")}\n`);
+	}
+}

package/src/cli.ts

@@ -23,6 +23,7 @@ const commands: CommandEntry[] = [
 	{ name: "plugin", load: () => import("./commands/plugin").then(m => m.default) },
 	{ name: "setup", load: () => import("./commands/setup").then(m => m.default) },
 	{ name: "shell", load: () => import("./commands/shell").then(m => m.default) },
+	{ name: "ssh", load: () => import("./commands/ssh").then(m => m.default) },
 	{ name: "stats", load: () => import("./commands/stats").then(m => m.default) },
 	{ name: "update", load: () => import("./commands/update").then(m => m.default) },
 	{ name: "search", load: () => import("./commands/web-search").then(m => m.default), aliases: ["q"] },

package/src/commands/ssh.ts

@@ -0,0 +1,60 @@
+/**
+ * Manage SSH host configurations.
+ */
+import { Args, Command, Flags } from "@oh-my-pi/pi-utils/cli";
+import { runSSHCommand, type SSHAction, type SSHCommandArgs } from "../cli/ssh-cli";
+import { initTheme } from "../modes/theme/theme";
+
+const ACTIONS: SSHAction[] = ["add", "remove", "list"];
+
+export default class SSH extends Command {
+	static description = "Manage SSH host configurations";
+
+	static args = {
+		action: Args.string({
+			description: "SSH action",
+			required: false,
+			options: ACTIONS,
+		}),
+		targets: Args.string({
+			description: "Host name or arguments",
+			required: false,
+			multiple: true,
+		}),
+	};
+
+	static flags = {
+		json: Flags.boolean({ description: "Output JSON" }),
+		host: Flags.string({ description: "Host address" }),
+		user: Flags.string({ description: "Username" }),
+		port: Flags.string({ description: "Port number" }),
+		key: Flags.string({ description: "Identity key path" }),
+		desc: Flags.string({ description: "Host description" }),
+		compat: Flags.boolean({ description: "Enable compatibility mode" }),
+		scope: Flags.string({ description: "Config scope (project|user)", options: ["project", "user"] }),
+	};
+
+	async run(): Promise<void> {
+		const { args, flags } = await this.parse(SSH);
+		const action = (args.action ?? "list") as SSHAction;
+		const targets = Array.isArray(args.targets) ? args.targets : args.targets ? [args.targets] : [];
+
+		const cmd: SSHCommandArgs = {
+			action,
+			args: targets,
+			flags: {
+				json: flags.json,
+				host: flags.host,
+				user: flags.user,
+				port: flags.port,
+				key: flags.key,
+				desc: flags.desc,
+				compat: flags.compat,
+				scope: flags.scope as "project" | "user" | undefined,
+			},
+		};
+
+		await initTheme();
+		await runSSHCommand(cmd);
+	}
+}

package/src/commit/prompts/analysis-system.md

@@ -76,7 +76,6 @@ Call create_conventional_analysis with:
 }
 </output_format>
 
-<examples>
 <example name="feature-with-api">
 {
   "type": "feat",
@@ -146,5 +145,4 @@ Call create_conventional_analysis with:
   "details": [],
   "issue_refs": []
 }
-</example>
-</examples>
+</example>

package/src/config/prompt-templates.ts

@@ -230,13 +230,28 @@ handlebars.registerHelper("jtdToTypeScript", (schema: unknown): string => jtdToT
 handlebars.registerHelper("jsonStringify", (value: unknown): string => JSON.stringify(value));
 
 /**
- * {{hashline lineNum "content"}} — compute a real hashline ref for prompt examples.
- * Returns `"lineNum:hash"` using the actual hash algorithm.
+ * {{hlineref lineNum "content"}} — compute a real hashline ref for prompt examples.
+ * Returns `"lineNum#hash"` using the actual hash algorithm.
  */
-handlebars.registerHelper("hashline", (lineNum: unknown, content: unknown): string => {
+function formatHashlineRef(lineNum: unknown, content: unknown): { num: number; text: string; ref: string } {
 	const num = typeof lineNum === "number" ? lineNum : Number.parseInt(String(lineNum), 10);
-	const str = typeof content === "string" ? content : String(content ?? "");
-	return `${num}:${computeLineHash(num, str)}`;
+	const text = typeof content === "string" ? content : String(content ?? "");
+	const ref = `${num}#${computeLineHash(num, text)}`;
+	return { num, text, ref };
+}
+
+handlebars.registerHelper("hlineref", (lineNum: unknown, content: unknown): string => {
+	const { ref } = formatHashlineRef(lineNum, content);
+	return ref;
+});
+
+/**
+ * {{hlinefull lineNum "content"}} — format a full read-style line with prefix.
+ * Returns `"lineNum#hash:content"`.
+ */
+handlebars.registerHelper("hlinefull", (lineNum: unknown, content: unknown): string => {
+	const { ref, text } = formatHashlineRef(lineNum, content);
+	return `${ref}:${text}`;
 });
 
 export function renderPromptTemplate(template: string, context: TemplateContext = {}): string {

package/src/config/settings-schema.ts

@@ -287,7 +287,7 @@ export const SETTINGS_SCHEMA = {
 		ui: {
 			tab: "config",
 			label: "Read hash lines",
-			description: "Include line hashes in read output for hashline edit mode (LINE:HASH|content)",
+			description: "Include line hashes in read output for hashline edit mode (LINE#ID:content)",
 		},
 	},
 	showHardwareCursor: {
@@ -502,6 +502,15 @@ export const SETTINGS_SCHEMA = {
 			description: "Launch browser in headless mode (disable to show browser UI)",
 		},
 	},
+	"tools.intentTracing": {
+		type: "boolean",
+		default: false,
+		ui: {
+			tab: "tools",
+			label: "Intent tracing",
+			description: "Ask the agent to describe the intent of each tool call before executing it",
+		},
+	},
 
 	// ─────────────────────────────────────────────────────────────────────────
 	// Task tool settings