inflow

InFlow — Agent Enrollment Protocol access and agentic MPP (Machine Payments Protocol) / x402 payments from your machine.

The agent-native and human-accessible command-line entry point to InFlow. Agentic buyers perform agent-native payments via MPP and x402, manage Agent Enrollment Protocol Service enrollment, and fetch resources that require AEP authentication before payment; humans hit the same functionality from MCP-integrated assistants or the raw CLI.

New here? Start with the command reference in packages/cli/README.md — it covers auth, the x402 and mpp command groups, the global flags, and the agent (--format) renderings.

Installing into an agent host? Use the per-surface guide: docs/development/surfaces-and-testing.md.

Install

The signed native inflow binary is distributed for Apple Silicon and Intel Macs.

Homebrew Cask

brew tap inflowpayai/tap
brew install --cask inflow
inflow --version

Upgrade or uninstall through Homebrew:

brew upgrade --cask inflow
brew uninstall --cask inflow

Hosted installer

curl -fsSL https://inflowcli.ai/install.sh | bash

The installer selects the current Mac architecture, downloads the matching GitHub Release asset and checksum, verifies the checksum plus macOS code-signing and Gatekeeper checks, installs InFlow.app into ~/.local/share/inflow, and links inflow into ~/.local/bin.

Run the installer again to upgrade to the latest GitHub Release. Uninstall with:

curl -fsSL https://inflowcli.ai/install.sh | bash -s -- --uninstall

PowerShell on macOS can use the same hosted installer surface:

iwr -useb https://inflowcli.ai/install.ps1 | iex

PowerShell uninstall:

$env:INFLOW_UNINSTALL = "1"; iwr -useb https://inflowcli.ai/install.ps1 | iex

Direct download

Download the matching zip from the inflowpayai/inflow-cli GitHub Release for the package version:

inflow-<version>-darwin-arm64.zip for Apple Silicon Macs
inflow-<version>-darwin-x64.zip for Intel Macs

The zip contains InFlow.app; the executable is inside the app bundle at InFlow.app/Contents/MacOS/inflow.

Use with agents

Install the agentic-enrollment and agentic-payments skills into a skills-aware agent:

npx skills add inflowpayai/inflow-cli

The repo also ships as an installable plugin (skill + MCP server bundled) for plugin-aware hosts:

Claude Code — add the marketplace, then install the plugin:
```
/plugin marketplace add inflowpayai/inflow-cli
/plugin install inflow@inflow
```
Here inflowpayai/inflow-cli is the GitHub repo slug; the marketplace, plugin, and binary are all named inflow, so the install target is inflow@inflow.
Cursor / Codex — point the host at this repo; it discovers .cursor-plugin/marketplace.json, .agents/plugins/marketplace.json, and .codex-plugin/plugin.json respectively.

In every case the plugin bundles the skill and the inflow MCP server (.mcp.json). The default MCP entry runs inflow --mcp; install the signed native binary before using the MCP server.

Development

This is a pnpm + Turborepo monorepo. Node >= 24.15.0 required.

pnpm install
pnpm build
pnpm test

Other useful tasks:

pnpm typecheck
pnpm lint
pnpm typedoc
pnpm changeset

macOS release automation

The macos release workflow is manually dispatched from GitHub Actions. Its default dry run builds the Apple Silicon and Intel macOS artifacts, renders the Homebrew Cask, audits the Cask, and uploads workflow artifacts without notarizing, creating a GitHub Release, or pushing inflowpayai/homebrew-tap.

Real release runs require these repository secrets:

APPLE_DEVELOPER_ID_APPLICATION_CERTIFICATE_BASE64
APPLE_DEVELOPER_ID_APPLICATION_CERTIFICATE_PASSWORD
APPLE_NOTARY_APPLE_ID
APPLE_NOTARY_APP_SPECIFIC_PASSWORD
APPLE_NOTARY_TEAM_ID
HOMEBREW_TAP_APP_PRIVATE_KEY

Real release runs also require this repository variable:

HOMEBREW_TAP_APP_CLIENT_ID

The published macOS artifacts are attached to the inflowpayai/inflow-cli GitHub Release for the package version, and the Homebrew Cask in inflowpayai/homebrew-tap points at those release assets for Apple Silicon and Intel Macs.

Packages

@inflowpayai/inflow (packages/cli) — the published binary, and the entry point for anyone integrating InFlow. Thin render shell over inflow-core. See packages/cli/README.md for the full command reference.
@inflowpayai/inflow-core (packages/core) — the headless InFlow client behind the binary. One augmented handle per command group (inflow.auth, inflow.user, inflow.balances, inflow.depositAddresses, inflow.x402, inflow.mpp) carrying both protocol primitives and the command-shaped operations, plus the helpers (sanitization, polling, seller-probe) that make both work. Workspace-internal today; see packages/core/examples/ for runnable scripts.

Repository

https://github.com/inflowpayai/inflow-cli

Inflow CLI

README