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