Pi Mattermost Bridge

Bridge Pi coding agent sessions to Mattermost channels. Control your Pi agents through slash commands in Mattermost with real-time streaming, session management, and systemd integration.

Install

pi install npm:@whonixnetworks/pi-mattermost

Or install globally via npm:

npm install -g @whonixnetworks/pi-mattermost

After installing, make sure pi-mattermost is on your PATH:

pi-mattermost path

This prints the correct export line for your shell. Add it to ~/.bashrc or ~/.zshrc for permanent setup.

Quick Start

1. Start the bridge

Generate and edit config, then install the systemd service:

pi-mattermost config
# Edit ~/.config/pi-mattermost/config.toml with your Mattermost credentials
pi-mattermost install
systemctl --user daemon-reload
systemctl --user enable --now pi-mattermost

2. Connect from Pi

Start Pi in any project directory and type:

/connect

Pi sends the project path to the bridge, which creates a Mattermost channel and spawns a managed Pi process. All agent activity streams to the Mattermost channel in real time.

3. Or connect from Mattermost

In any Mattermost channel, type:

/pi-connect /path/to/your/project

A new channel opens with a live Pi agent session.

Pi TUI Commands

| Command | Description | |---------|-------------| | /connect | Connect current project to Mattermost | | /disconnect | Disconnect from Mattermost |

CLI Commands

| Command | Description | |---------|-------------| | pi-mattermost config | Generate default config file | | pi-mattermost path | Show safe PATH setup instructions | | pi-mattermost start | Start bridge (foreground) | | pi-mattermost install | Install systemd user service | | pi-mattermost uninstall | Remove systemd user service |

Configuration

File: ~/.config/pi-mattermost/config.toml

[mattermost]
url = "https://matrix.example.com"
bot_token = "your-bot-token"
team_id = "your-team-id"
http_port = 4000

[pi]
default_model = "zai/glm-4.7"
subagent_model = "zai/glm-4.5-flash"

[logging]
level = "INFO"

License

MIT