pidnap

Process manager with init-system capabilities for tasks, cron jobs, and long-running processes.

Install

pnpm install

Run

pidnap init

By default, this looks for pidnap.config.ts in the current directory. To use a different config file:

pidnap init --config path/to/config.ts

CLI

pidnap status
pidnap processes list
pidnap processes add --name api --definition '{"command":"node","args":["server.js"]}'
pidnap processes restart api
pidnap crons list
pidnap tasks list
pidnap tasks remove task-1

Architecture

• CLI: src/cli.ts loads config, starts RPC server, boots manager
• Core: src/manager.ts orchestrates tasks, crons, and restarting processes
• Runtime: src/lazy-process.ts executes processes; src/restarting-process.ts handles restarts
• Scheduling: src/cron-process.ts manages cron jobs with retry/queue
• Env: src/env-manager.ts loads .env + watches for reloads
• API: src/api/contract.ts defines ORPC contract, src/api/server.ts implements it

Development

pnpm run typecheck
pnpm run lint
pnpm run format
pnpm test