plit

Pipelit ecosystem CLI

Supported platforms: Linux, macOS, Windows, Raspberry Pi, iSH (iOS).

Install

curl -sSf https://raw.githubusercontent.com/theuselessai/plit/main/install.sh | sh

Or via Cargo:

cargo install plit

Pre-built static binaries are available for Linux (x86_64, aarch64, i686), macOS (Intel, Apple Silicon), and Windows.

Quick start

# 1. Interactive setup: configure Pipelit, your LLM provider, and credentials
plit init

# 2. Start the gateway, Pipelit, and workers
plit start

That's it. You're running.

Commands

plit init

Interactive wizard. Walks you through:

• Connecting to your Pipelit instance
• Configuring an LLM provider
• Creating initial credentials

On macOS and Windows, plit init detects the platform and switches to Docker mode automatically — pulling and running the plit Docker image.

Run this once before anything else.

plit start / plit stop

Start and stop the full stack: gateway, Pipelit, and background workers. On Linux, managed via honcho. On macOS/Windows, managed via Docker.

plit start
plit stop

plit chat

Interactive REPL for chatting with your configured agent.

plit chat my_credential --chat-id session-1

plit send

One-shot message. Pipe-friendly.

plit send my_credential --chat-id session-1 --text "Hello"
echo "summarize this" | plit send my_credential --chat-id session-1

Output is plain text on a TTY, JSON when piped. Pass --json to force JSON anywhere.

plit listen

Stream incoming messages as JSONL over WebSocket. Useful for scripting and log tailing.

plit listen my_credential --chat-id session-1
plit listen my_credential --chat-id session-1 | jq .

plit credentials

Manage gateway credentials.

plit credentials list
plit credentials create --name my-bot
plit credentials activate <id>
plit credentials deactivate <id>

plit health

Check gateway and backend health.

plit health

plit uninstall

Remove configuration and stop running services.

plit uninstall

Environment variables

These override values from the config file written by plit init.

Output modes

plit adapts its output to context:

• TTY — human-readable, formatted
• Piped — JSON automatically
• --json — force JSON regardless of context

Architecture

plit is a thin CLI wrapper around plit-gw. Installing plit gives you both the command-line interface and the gateway server in a single cargo install. The gateway handles protocol adapters, message routing, and backend connections. The CLI handles setup, process management, and user-facing interaction.

For gateway configuration, adapter setup, and backend protocol details, see the plit-gw repository.

Related

• plit-gw — the gateway crate
• Pipelit — the agent orchestration platform

License

Apache 2.0. See LICENSE.