matrix

name	matrix
description	Configure and operate the Matrix connector through puffer serve.
allowed-tools	["Bash"]
argument-hint	[Matrix connector task]
arguments	target
user-invocable	true
disable-model-invocation	false

Use the matrix-bot connector when the user wants a Matrix account to bridge room messages into Puffer through puffer serve.

Target: $target

Configuration lives in .puffer/connectors.toml or ~/.puffer/connectors.toml under [connectors.matrix]. The connector uses password login for a Matrix account.

[connectors.matrix]
homeserver_url = "https://matrix.example.org"
username = "bot"
password = "..."
require_mention = true
group_key_policy = "per_user"

Run puffer serve after configuring the connector. The connector handles inbound Matrix messages directly through the connector runtime; it is not a workflow trigger yet and should not be used in WorkflowCreate connection triggers until a typed subscriber or connector protocol stream exists.