SSH Deployment Tool

Catapult JS

Deploy Node.js applications over SSH.

Get Started GitHub

npx @catapultjs/deploy init

⚡

SSH-based

Deploy directly over SSH. No agents, no containers, no server-side dependencies, just a remote shell.

🔧

Pipeline-driven

Composable task pipeline. Insert, remove or replace any step with a single function call.

📦

Recipes

Drop-in recipes for AdonisJS, PM2 and rsync. Import once, tasks are registered automatically.

↩️

Auto rollback

On failure after publish, the previous release is restored automatically.

🌐

Multi-server

Deploy to staging and production in the same run. Target a single host with --host.

🔌

Extensible

Define custom tasks, hooks and recipes. Full async support with TaskContext.

📜

Programmatic API

Drive deployments from scripts, CI or bots with the Catapult class. Events, captured output, JSON reports.

🤖

Agent-ready

Ships with agent skills for Claude Code. Your AI assistant writes configs and recipes following the conventions.

Up and running in minutes

Init

npx @catapultjs/deploy init

Configure

import { defineConfig } from '@catapultjs/deploy'

export default defineConfig({
  keepReleases: 5,
  hosts: [{
    name: 'production',
    ssh: 'deploy@example.com',
    deployPath: '/home/deploy/myapp',
    branch: 'main',
  }],
})

Deploy

npx cata deploy