Pulp

# Pulp

[![SDK](https://img.shields.io/github/v/release/Generous-Corp/pulp?label=SDK%20%2F%20CLI)](https://github.com/Generous-Corp/pulp/releases)
[![Claude plugin](https://img.shields.io/github/v/tag/Generous-Corp/pulp?filter=plugin-v*&label=Claude%20plugin)](https://github.com/Generous-Corp/pulp/tags)
[![Coverage](https://codecov.io/gh/Generous-Corp/pulp/branch/main/graph/badge.svg)](https://app.codecov.io/gh/Generous-Corp/pulp)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE.md)

A cross-platform audio plugin and application framework. MIT licensed, C++20 core, Swift on Apple, JS-scripted GPU UIs.

## Install

**macOS / Linux**

```bash
curl -fsSL https://www.generouscorp.com/pulp/install.sh | sh
```

**Windows (PowerShell)**

```powershell
irm https://www.generouscorp.com/pulp/install.ps1 | iex
```

The macOS/Linux installer normally adds the matching SDK after the CLI; the
Windows installer currently installs the CLI only. Before SDK-backed builds,
check `pulp sdk status` and run `pulp sdk install` if no matching SDK is listed.

<details>
<summary><strong>Optional: Verify before installation</strong> (click to expand)</summary>

For an additional layer of security, you can download the installer and verify its SHA-256 checksum before running it:

**macOS / Linux**

```bash
(
  set -e
  curl -fLso install.sh https://www.generouscorp.com/pulp/install.sh
  curl -fLso SHA256SUMS https://raw.githubusercontent.com/Generous-Corp/pulp/main/tools/install/SHA256SUMS
  if command -v sha256sum >/dev/null; then
    sha256sum -c SHA256SUMS --ignore-missing
  else
    shasum -a 256 -c SHA256SUMS --ignore-missing
  fi
  sh install.sh
)
```

**Windows (PowerShell)**

```powershell
Invoke-WebRequest https://www.generouscorp.com/pulp/install.ps1 -OutFile install.ps1
Invoke-WebRequest https://raw.githubusercontent.com/Generous-Corp/pulp/main/tools/install/SHA256SUMS -OutFile SHA256SUMS
$expected = (Select-String -Path .\SHA256SUMS -Pattern ' install\.ps1$').Line.Split()[0]
$actual = (Get-FileHash .\install.ps1 -Algorithm SHA256).Hash.ToLowerInvariant()
if ($actual -ne $expected) { throw "Checksum mismatch for install.ps1" }
powershell -ExecutionPolicy Bypass -File .\install.ps1
```

The checksum confirms that the installer you downloaded matches the script
Pulp publishes in source control. It does not replace reading a network script
before running it, but it avoids executing bytes that differ from the published
checksum.

Prefer not to run the installer? You can [build Pulp from source](#build-from-source).

GitHub's release verification can also check immutable releases and downloaded
release assets. This path requires the GitHub CLI:

```bash
version=0.614.0
asset=pulp-darwin-arm64.tar.gz
gh release download "v${version}" -R Generous-Corp/pulp -p "$asset"
gh release verify "v${version}" -R Generous-Corp/pulp
gh release verify-asset "v${version}" "$asset" -R Generous-Corp/pulp
```

These layers answer different questions. A verified commit or tag means GitHub
verified a signature from a configured maintainer or release-bot signing key for
the source ref. A SHA-256 check means the bytes you downloaded match the bytes
Pulp published. Neither replaces reading code you are about to execute, but
together they make the source identity and downloaded artifact integrity much
clearer.

</details>

### Optional: install the Claude Code plugin

```bash
claude plugin marketplace add Generous-Corp/pulp && claude plugin install pulp
```

<details>
<summary><strong>Learn more</strong></summary>

The CLI works great with any AI coding agent (Claude, Codex, Cursor). If you use
**Claude Code**, you can additionally install the
[Pulp plugin](docs/agent-integrations.md#claude-code-with-the-optional-plugin)
for slash-command shortcuts (`/build`, `/test`, `/ship`) and a native MCP
server.

Install the CLI first. The plugin's MCP server is `pulp-mcp`, which ships with
the CLI tarball (above) into `~/.pulp/bin/`. The plugin itself contains no
binaries; the CLI installer sets `PULP_MCP_BINARY` to its full path rather than
depending on Claude Code's inherited `PATH`. If you install the plugin before
the CLI, `/mcp` reports that `PULP_MCP_BINARY` is missing. Restart the shell
after installation, then run
`pulp doctor` to confirm `pulp-mcp` is found and matches your CLI version.

Building from a source checkout instead? The repo's project-local MCP server
uses `PULP_MCP_BINARY` to select your build-tree executable. See
[Build from source](#build-from-source). No CLI install is needed.

</details>

See [docs/agent-integrations.md](docs/agent-integrations.md) for details on each agent path.

To find an area's native source of truth, run `pulp authority list`, then query
an exact ID or alias such as `pulp authority query dsp` or
`pulp authority query timeline`.

## Features

The full status inventory lives in the
[Capabilities Reference](docs/reference/capabilities.md).

- **Plugin formats:** VST3, Audio Unit v2, AUv3, CL

... (truncated)