diff --git a/electron/mcp/netcattyMcpInstructions.cjs b/electron/mcp/netcattyMcpInstructions.cjs index 83fa4d52c..7ecf50fef 100644 --- a/electron/mcp/netcattyMcpInstructions.cjs +++ b/electron/mcp/netcattyMcpInstructions.cjs @@ -1,6 +1,6 @@ "use strict"; const NETCATTY_MCP_SERVER_INSTRUCTIONS = - "Use Netcatty tools for terminals, hosts, SFTP, vault, snippets/scripts, and port forwards. For terminal work, call get_environment first; select by label or hostname and pass sessionId to terminal_execute/terminal_start. Never use the local shell for Netcatty session commands. If none matches, use vault_hosts_list and host_open. 15 core tools start loaded. For attachments, advanced SFTP, vault/notes, snippets, scripts, or port forwards, call load_netcatty_tools with a toolset; use all for every tool."; + "Call get_environment first; select by label or hostname and pass sessionId to terminal tools. Never use the local shell for Netcatty session commands. If none matches, use vault_hosts_list and host_open. 15 core tools start loaded. Use load_netcatty_tools: sessions, attachments, sftp_advanced, vault_hosts, vault_notes, snippets, scripts, portforward, or all. For disconnected in-scope sessions, load sessions; use session_reconnect/session_recover instead of host_open (creates a new tab)."; module.exports = { NETCATTY_MCP_SERVER_INSTRUCTIONS }; diff --git a/electron/mcp/netcattyMcpInstructions.test.cjs b/electron/mcp/netcattyMcpInstructions.test.cjs index 00e18f6f4..4b23dec52 100644 --- a/electron/mcp/netcattyMcpInstructions.test.cjs +++ b/electron/mcp/netcattyMcpInstructions.test.cjs @@ -18,6 +18,9 @@ test("MCP server instructions route Netcatty terminal work through environment d assert.match(NETCATTY_MCP_SERVER_INSTRUCTIONS, /vault_hosts_list and host_open/); assert.match(NETCATTY_MCP_SERVER_INSTRUCTIONS, /load_netcatty_tools/); assert.match(NETCATTY_MCP_SERVER_INSTRUCTIONS, /15 core tools/); + assert.match(NETCATTY_MCP_SERVER_INSTRUCTIONS, /load_netcatty_tools: sessions,/); + assert.match(NETCATTY_MCP_SERVER_INSTRUCTIONS, /disconnected in-scope sessions, load sessions/); + assert.match(NETCATTY_MCP_SERVER_INSTRUCTIONS, /session_reconnect\/session_recover instead of host_open \(creates a new tab\)/); }); test("stdio MCP server publishes the routing instructions during initialization", () => { diff --git a/skills/netcatty-mcp/SKILL.md b/skills/netcatty-mcp/SKILL.md index 3828083c0..841554929 100644 --- a/skills/netcatty-mcp/SKILL.md +++ b/skills/netcatty-mcp/SKILL.md @@ -11,7 +11,8 @@ Use the Netcatty MCP tools whenever the task targets Netcatty or a remote sessio - For terminal work, call `get_environment` first. Select the current target by its label or hostname and pass its `sessionId` to terminal tools. - Never use the local shell for commands intended for a Netcatty session. -- If a required specialized tool is not visible, call `load_netcatty_tools` with `attachments`, `sftp_advanced`, `vault_hosts`, `vault_notes`, `snippets`, `scripts`, or `portforward`. Use `all` only when several categories are needed. +- If a required specialized tool is not visible, call `load_netcatty_tools` with `sessions`, `attachments`, `sftp_advanced`, `vault_hosts`, `vault_notes`, `snippets`, `scripts`, or `portforward`. Use `all` only when several categories are needed. +- For disconnected sessions already in scope, load `sessions` and use `session_reconnect` / `session_recover` instead of `host_open`, which creates a new tab. - If no live session matches, use `vault_hosts_list` and `host_open`. A newly opened tab lands in your own bound workspace by default (workspace chat → that workspace; terminal chat → that terminal's workspace); only pass `workspaceId` when the user asks for a different target. Close only sessions opened for the current task when they are no longer needed. - Use `terminal_execute` for short commands. Use `terminal_start`, `terminal_poll`, and `terminal_stop` for long-running or streaming commands. - Treat Netcatty permission denials and tool errors as authoritative. Do not bypass them with local commands or alternate connection tools.