Installation

Getting started with proc is simple—it’s just a Deno import away.

Import from JSR

Add proc to your Deno project:

import * as proc from "jsr:@j50n/proc@0.24.6";

Or import just what you need:

import { enumerate, read, run } from "jsr:@j50n/proc@0.24.6";

That’s it! No installation step, no package.json, no node_modules.

Data Transforms (Optional)

The data transforms module is separate from the core library to keep the main import lightweight. Import it when you need CSV, TSV, JSON, or Record format conversions:

// Core library - process management and async iterables
import { enumerate, read, run } from "jsr:@j50n/proc@0.24.6";

// Data transforms - CSV, TSV, JSON, Record conversions
import { fromCsvToRows, toTsv } from "jsr:@j50n/proc@0.24.6/transforms";

Why separate?

• Smaller bundles: Users who only need process management don’t import transform code
• Clear separation: Core library vs specialized data format conversions
• Optional feature: Transforms are powerful but not required for basic usage

See the Data Transforms guide for details.

Permissions

proc needs permissions to run child processes and access files. When you run your script, Deno will prompt you, or you can grant them upfront:

deno run --allow-run --allow-read your-script.ts

Common permissions:

• --allow-run - Required to run child processes
• --allow-read - Needed to read files
• --allow-write - Needed to write files
• --allow-env - If your processes need environment variables

You can be more specific:

# Only allow running specific commands
deno run --allow-run=ls,grep,wc your-script.ts

# Only allow reading specific directories
deno run --allow-read=/var/log your-script.ts

Version Pinning

For production, pin to a specific version:

import { run } from "jsr:@j50n/proc@1.0.0";

For development, use the latest:

import { run } from "jsr:@j50n/proc";

Next Steps

Ready to write your first proc script? Head to the Quick Start guide.