zhaolei
3c72efcb7f
Some checks failed
build-packages / resolve bundled mosh-client (push) Has been cancelled
build-packages / resolve bundled et-client (push) Has been cancelled
build-packages / build-macos (push) Has been cancelled
build-packages / build-windows (push) Has been cancelled
build-packages / build-linux-x64 (push) Has been cancelled
build-packages / build-linux-arm64 (push) Has been cancelled
build-packages / release (push) Has been cancelled
build-packages / update Nix release metadata (push) Has been cancelled
build-packages / bump homebrew tap (push) Has been cancelled
test / lint-and-test (push) Has been cancelled
AI automation / Route event (push) Has been cancelled
AI automation / Hand reopened issue to maintainers (push) Has been cancelled
AI automation / Clean source issue state (push) Has been cancelled
AI automation / Reconcile handoffs (push) Has been cancelled
AI automation / Classify issue (push) Has been cancelled
AI automation / Claude Code smoke (push) Has been cancelled
AI automation / Review issue follow-up (push) Has been cancelled
AI automation / Publish issue follow-up (push) Has been cancelled
AI automation / Implement with Claude Code (push) Has been cancelled
AI automation / Publish implement PR (push) Has been cancelled
AI automation / Continue queued issue comments (push) Has been cancelled
AI automation / Codex review loop (push) Has been cancelled
AI automation / Publish Codex fix (push) Has been cancelled
AI automation / Clear Codex dispatch marker (push) Has been cancelled
AI automation / Own PR re-request Codex (push) Has been cancelled
AI automation / External PR re-request Codex (push) Has been cancelled
AI automation / Poll Codex reaction / retry (push) Has been cancelled
build-et-binaries / build-linux-x64 (push) Has been cancelled
build-et-binaries / build-linux-arm64 (push) Has been cancelled
build-et-binaries / build-macos-universal (push) Has been cancelled
build-et-binaries / build-windows-x64 (push) Has been cancelled
build-et-binaries / release (push) Has been cancelled
48 lines
3.2 KiB
Markdown
48 lines
3.2 KiB
Markdown
---
|
|
name: netcatty-tool-cli
|
|
description: Use this skill when an external agent needs to operate on Netcatty sessions through Skills + CLI instead of the netcatty-remote-hosts MCP server.
|
|
---
|
|
|
|
# Netcatty Tool CLI
|
|
|
|
Use this skill for external ACP agents when Netcatty is configured for `Skills + CLI` mode.
|
|
|
|
For routine tasks, the host prompt is usually enough. Read only the reference that matches the task type.
|
|
|
|
## Router
|
|
|
|
1. Use the exact Netcatty CLI prefix provided by the host prompt.
|
|
2. Keep `--chat-session <chat-session-id>` on every Netcatty CLI call. Do not omit it.
|
|
3. Treat `--chat-session <chat-session-id>` as required for `env`, `session`, real `exec`, and every `sftp` operation. Treat `--session <session-id>` as required for `session`, `exec`, and every `sftp` operation.
|
|
4. Classify the task before choosing a command path:
|
|
- Remote command execution tasks go through the exec reference.
|
|
- Remote file or directory tasks go through the sftp reference.
|
|
- If the user explicitly says to avoid shell or `exec`, do not use `exec`.
|
|
- Treat `exec` as the short-command path only. If the command may exceed about 60 seconds, or streams output for an extended period, use the long-running job commands instead of plain `exec`.
|
|
5. If the host prompt already names a connected default target session, use that session directly for routine requests that do not mention another session or host, but still start with `session --session <id> --json --chat-session <chat-session-id>` instead of jumping straight to `exec` or `sftp`.
|
|
6. Only fall back to `env` lookup when the task is ambiguous, the user points to another session, or that direct `session` lookup fails.
|
|
|
|
## Core Rules
|
|
|
|
- Treat the host-provided CLI prefix as the only supported entrypoint for this session.
|
|
- If a command launcher is needed, prefer the operating system's built-in launcher for the current environment; do not require optional shells that may not be installed.
|
|
- Run Netcatty CLI commands strictly serially.
|
|
- Treat Netcatty CLI errors as authoritative.
|
|
- Never ask the user for SSH credentials, key paths, proxy settings, or jump-host details when Netcatty session access already exists.
|
|
- Do not pause to explain the plan, re-read this skill, or design scripts before trying that shortest path.
|
|
- When presenting structured results, prefer a concise table if it fits clearly.
|
|
|
|
Examples:
|
|
|
|
- On Windows, if a literal shell command line is required, use the host-provided prefix with the system launcher available in the environment, such as `cmd.exe` or Windows PowerShell; do not assume PowerShell 7 `pwsh.exe` exists.
|
|
- On macOS or Linux, use the host-provided prefix directly, or the system shell already available in that environment when a shell command line is unavoidable.
|
|
- When the execution surface accepts argv-style calls, use the Netcatty launcher path as the executable and pass subcommands and flags as separate arguments instead of wrapping it in another shell.
|
|
|
|
## References
|
|
|
|
- Exec and session workflow: `references/exec.md`
|
|
- SFTP file workflow: `references/sftp.md`
|
|
- Session and device-type handling: `references/session-types.md`
|
|
- Cancel, resume, and runtime diagnostics: `references/control-commands.md`
|
|
- Error handling and authoritative failures: `references/errors.md`
|