Skip to content

CLI Commands

Usage

Terminal window
feedpipe <port> [options]

Arguments

<port>

Required. The local port to tunnel.

Terminal window
feedpipe 3000
feedpipe 8080

Options

-s, --slug <slug>

Custom URL slug instead of a random one.

Terminal window
feedpipe 3000 --slug my-feature
# → https://my-feature.feedpipe.dev

Slugs must be lowercase alphanumeric with hyphens. If the slug is taken, you’ll get an error.

-h, --host <host>

Local host to tunnel. Defaults to localhost.

Terminal window
feedpipe 3000 --host 127.0.0.1
feedpipe 3000 --host 0.0.0.0

-p, --password <password>

Password protect the tunnel.

Terminal window
feedpipe 3000 --password secret123

Reviewers will see a login page and must enter the password to access.

--no-toolbar

Disable toolbar injection. Useful if you just want tunneling without annotations.

Terminal window
feedpipe 3000 --no-toolbar

--open

Open the tunnel URL in your default browser.

Terminal window
feedpipe 3000 --open

--no-telemetry

Disable anonymous usage telemetry.

Terminal window
feedpipe 3000 --no-telemetry

-q, --quiet

Minimal output. Only errors are printed.

Terminal window
feedpipe 3000 --quiet

--json

JSON output mode. Each event is printed as a JSON object on its own line.

Terminal window
feedpipe 3000 --json

Example output:

{"type":"ready","url":"https://abc123.feedpipe.dev"}
{"type":"event","event":{"type":"annotation.created",...}}

-V, --version

Print the version number.

Terminal window
feedpipe --version

--help

Print help information.

Terminal window
feedpipe --help

AI Integration Options

See AI Integration for details.

--ai <agent>

Pipe events to an AI coding agent.

Terminal window
feedpipe 3000 --ai claude
feedpipe 3000 --ai codex
feedpipe 3000 --ai gemini
feedpipe 3000 --ai opencode
feedpipe 3000 --ai custom

--ai-command <cmd>

Custom command for the AI agent (used with --ai custom).

Terminal window
feedpipe 3000 --ai custom --ai-command "my-agent --mode feedback"

--ai-cwd <dir>

Working directory for the AI agent.

Terminal window
feedpipe 3000 --ai claude --ai-cwd /path/to/project

--ai-filter <types>

Filter which event types are piped to the AI agent.

Terminal window
feedpipe 3000 --ai claude --ai-filter pin_comment,rect_highlight

Environment Variables

FEEDPIPE_DEV

When set, uses localhost for the relay instead of production.

Terminal window
FEEDPIPE_DEV=1 feedpipe 3000

FEEDPIPE_TELEMETRY_DISABLED

Disable anonymous usage telemetry.

Terminal window
FEEDPIPE_TELEMETRY_DISABLED=1 feedpipe 3000

FEEDPIPE_TELEMETRY_DEBUG

Enable verbose telemetry logging (for troubleshooting only).

Terminal window
FEEDPIPE_TELEMETRY_DEBUG=1 feedpipe 3000

Exit Codes

  • 0 - Clean shutdown (Ctrl+C)
  • 1 - Error (connection failed, invalid port, etc.)