Pitcrew Documentation

Learn the language, explore the standard library, and see real-world examples.

$ curl -fsSL https://pitcrew.io/install | sh

Getting Started

Learn pitcrew from scratch — variables, functions, types, SSH, error handling, pipes, and more.

Practical recipes for common tasks: deploying code, managing services, working with files.

Coming from shell scripts? A side-by-side guide mapping bash patterns to pitcrew.

Replacing playbooks? See how pitcrew handles inventory, tasks, handlers, and roles.

Create a file called hello.pit and run it:

// hello.pit
print("Hello from pitcrew!")

// Run a shell command
hostname := `hostname`
print("Running on", hostname)

$ pit run hello.pit
Hello from pitcrew!
Running on macbook.local

Run code on a remote host over SSH:

fn uptime() string {
  `uptime`
}

result := ssh uptime(), host: "my-server.com", user: "deploy"
print(result)

Pitcrew ships with modules for file I/O, networking, cloud providers, package management, and more. Browse the full reference →

Real-world scripts you can read, adapt, and run.

hello.pit

Minimal hello world

ssh.pit

Run commands over SSH

deploy-node.pit

Deploy a Node.js app

rolling-deploy.pit

Zero-downtime rolling deploy

nginx-proxy.pit

Set up nginx reverse proxy

postgres-replication.pit

Configure Postgres replication

secrets.pit

Encrypt and manage secrets

publish-website.pit

Deploy a site to S3 + CloudFront

Every variable, argument, and return value has a type checked at compile time. No runtime surprises.

ssh

The compiler understands execution boundaries. Code inside ssh blocks runs on the remote host.

Functions declare errors in their signature with !. Callers must catch or propagate.

Chain operations left-to-right with |>. Use map blocks for data transformation.