Know your environment
is ready

Declarative dev environment checks in YAML. Run one command, get instant diagnostics. No more "works on my machine."

Get Started Source
$ pulse

Gogo version go1.26.2 darwin/arm64
Node.jsv22.3.0
Dockerrunning
.env filefound
PostgreSQLlocalhost:5432 refused
fix: docker compose up db -d

4 passed · 1 failed · 87ms

Why teams use Pulse

One YAML file in your repo. Every developer runs pulse and knows instantly what's wrong.

Sub-200ms

All checks run concurrently. 10+ checks finish before your terminal repaints.

🔍

Validate, don't provision

Checks your environment without installing, modifying, or touching anything. Safe and read-only.

🛠

Suggested fixes

Each check can include a fix command. Run pulse --fix and it prompts before executing.

🎯

CI-native

JSON output, GitHub Actions annotations, proper exit codes. Drop it into any pipeline.

👥

Team-friendly

Groups, local overrides, config inheritance. Scale from solo projects to monorepos.

📄

Zero dependencies

Single static binary. No runtime, no daemon, no config server. Just drop it in your PATH.

Six check types

Cover the most common environment requirements out of the box.

command
CLI tools & versions
file
Config files exist
port
Services listening
env
Environment vars
http
Health endpoints
docker
Containers running
.pulse.yaml
checks:
  - name: Node.js
    type: command
    command: node --version
    expected: ">= 18.0"

  - name: PostgreSQL
    type: port
    host: localhost
    port: 5432
    groups: [backend]
    fix:
      run: "docker compose up db -d"

  - name: API Key
    type: env
    variable: API_KEY
    expected: "sk-*"

Install

Three ways, all under 10 seconds.

Quick install (Linux / macOS)

curl -sSL https://raw.githubusercontent.com/HugoAlvarezAjenjo/pulse/main/install.sh | sh

Go install

go install github.com/HugoAlvarezAjenjo/pulse/cmd/pulse@latest

Download binary

# See downloads below or grab from GitHub Releases

Downloads

Pre-built binaries for every platform. Grab the latest release.

Platform Architecture Format
🐦 Linux amd64 tar.gz
🐦 Linux arm64 tar.gz
🍎 macOS amd64 (Intel) tar.gz
🍎 macOS arm64 (Apple Silicon) tar.gz
🪟 Windows amd64 zip

View all downloads on GitHub Releases