@linely-io/cranky-node

Backend preset: core plus the SSH adapter, with a local fetch-capable environment. Does not install browser, JSDOM, or screenshot packages.

Requires Node.js 24+ for backend use and ES modules.

npm install @linely-io/cranky-node

import { createEngine } from '@linely-io/cranky-node';
const engine = createEngine(undefined, {
  connections: {
    server: {
      type: 'ssh',
      config: {
        host: process.env.SSH_HOST,
        username: process.env.SSH_USER,
        agent: process.env.SSH_AUTH_SOCK,
        hostHash: 'sha256',
        hostVerifier: (hash) => hash === process.env.SSH_HOST_SHA256_HEX,
      },
    },
  },
});
try {
  const run = await engine.run({
    connection: 'server',
    actions: [{ id: 'return', run: 'ssh.exec', params: 'uname -a' }],
  });
  if (run.error) throw run.error;
  console.log(run.toResultValue());
} finally {
  await engine.close();
}

Connections open lazily and persist across runs. Use the core package alone when SSH is unnecessary.

See package composition and connections.