@retr0h/nats
v2026.04.21.1
General-purpose NATS transport for swamp — exec, upload, wait for agent connection. Pairs with swamp-nats-agent (https://github.com/retr0h/swamp-nats-agent).
Repository
https://github.com/retr0h/swamp-nats
Labels
Quality score
How well-documented and verifiable this extension is.
Not yet scored.
A score will be generated the next time this extension is published. The owner can also trigger scoring manually.
Install
$ swamp extension pull @retr0h/natsRelease Notes
@adam/cfgmgmt drop-in compat: exports match adam's _lib/ssh.ts byte-for-byte (exec, execSudo, writeFile, writeFileAs, scpFile, scpFileAs, shellEscape, closeAll). nats_host globalArgs mirror cfgmgmt's GlobalArgsSchema (nodeHost, nodeUser, nodePort, nodeIdentityFile, become, becomeUser, becomePassword). Sudo moves from method args to globalArgs.
Security Notice
This extension includes AI agent skills that can modify AI assistant behavior. Review the skill files before installing.
Global Arguments
| Argument | Type | Description |
|---|---|---|
| nodeHost | string | Target hostname (maps to NATS subject suffix) |
| nodeUser | string | Agent-side user (SSH-era field, advisory) |
| nodePort | number | SSH port (ignored by NATS transport) |
| nodeIdentityFile? | string | SSH private key path (ignored by NATS transport) |
| become | boolean | Run commands with sudo on the agent |
| becomeUser | string | User to become when sudo is true |
| becomePassword? | string | Password for sudo -S (piped via stdin) |
| natsUrl | string | NATS server URL (nats://host:port) |
| natsSubjectPrefix | string | Subject prefix for multi-tenant namespace isolation |
| timeoutMs | number | Per-request timeout (ms) |
| natsUser? | string | NATS user/pass auth — username |
| natsPass? | string | NATS user/pass auth — password |
| natsToken? | string | NATS static token auth |
| natsCredsPath? | string | Path to NATS creds file (user JWT + nkey, recommended) |
| natsNKeySeed? | string | NATS nkey seed (alternative to creds file) |
| natsTlsCaFile? | string | mTLS — CA certificate file |
| natsTlsCertFile? | string | mTLS — client certificate file |
| natsTlsKeyFile? | string | mTLS — client key file |
| Argument | Type | Description |
|---|---|---|
| command | string | Command to execute |
| timeout | number | Enforced timeout in seconds (agent cancels via AbortSignal) |
| stdin? | string | Data to pipe to the command's stdin |
| Argument | Type | Description |
|---|---|---|
| dest | string | Remote destination path |
| content | string | File content — UTF-8 string or base64-encoded bytes |
| contentEncoding | enum | Encoding of content |
| mode? | string | File mode (octal, e.g. 0644) |
| owner? | string | File owner |
| group? | string | File group |
| Argument | Type | Description |
|---|---|---|
| timeout | number | Timeout in seconds |
Resources
General-purpose NATS transport for swamp — exec, upload, wait for agent connection. Pairs with swamp-nats-agent (https://github.com/retr0h/swamp-nats-agent).
Release Notes
Initial release — NATS (JetStream) transport for swamp, pairs with swamp-nats-agent