ChatrixCD - Matrix bot for CI/CD automation

✨ Why ChatrixCD?

🔐 Secure by Default

End-to-end encryption support, OIDC/SSO authentication, and device verification built-in.

🎭 Fun & Friendly

Sassy bot personality with emoji, and reaction confirmations. Never boring!

🖥️ Interactive TUI

Beautiful terminal interface for monitoring, room management, and device verification.

🚀 CI/CD Made Easy

Start, monitor, and manage Semaphore tasks directly from chat with real-time updates.

🧠 Smart Automation

Auto-fill parameters, smart log tailing, custom aliases, and confirmation flows.

🎨 Rich Formatting

Colored status indicators, formatted logs, HTML tables, and semantic emoji throughout.

🎯 Quick Start in 2 Steps

  1. Download & Run ChatrixCD

    Download the pre-built binary for Linux (no Python needed!) or install from source:

    wget https://github.com/CJFWeatherhead/ChatrixCD/releases/latest/download/chatrixcd-linux-x86_64.dist.tar.gz
tar -xzf chatrixcd-linux-x86_64.dist.tar.gz
cd chatrixcd-linux-x86_64.dist
./chatrixcd

    📖 Download Page →

  2. Start Automating!

    The bot will guide you through configuration. Invite it to your room and start managing CI/CD tasks:

    # In your Matrix room:
!cd projects
!cd run <project_id> <template_id>

    ⚡ Quick Start Guide →

🎨 Key Features

🔐 Security First

  • E2E Encryption: Full support for encrypted Matrix rooms
  • Device Verification: Emoji, QR code, and fingerprint verification
  • Native Auth: Password and OIDC/SSO with Matrix homeservers
  • Secure Storage: Encrypted credential storage

🎭 Delightful Experience

  • Threaded Responses: Organized conversations with thread replies
  • Reaction Confirmations: Quick 👍/👎 reactions for confirmations
  • Fun Personality: Varied greetings, sassy responses, emoji everywhere
  • Rich Formatting: Colored status, tables, formatted logs

🚀 Powerful Automation

  • Real-time Updates: Automatic status updates for running tasks
  • Smart Parameters: Auto-fill when only one option available
  • Command Aliases: Custom shortcuts for frequent commands
  • Enhanced Logs: Intelligent tailing for Ansible/Terraform

🖥️ Interactive TUI

  • Status Monitoring: View bot status, connections, metrics
  • Room Management: Manage Matrix rooms, invites, leaves
  • Device Verification: Interactive verification flows
  • Log Viewing: Real-time log streaming

📚 Documentation

📥 Download

Pre-built binaries for Linux

📥 Installation

From source, Docker, advanced options

⚡ Quick Start

Get up and running in minutes

⚙️ Configuration

Detailed config options

🖥️ TUI Guide

Terminal interface features

🏗️ Architecture

Technical design overview

🚀 Deployment

Production deployment options

🔒 Security

Security policy and best practices

🤝 Contributing

How to contribute to the project

❓ Support

Get help and troubleshooting

🎯 Use Cases

💼 DevOps Teams

  • Trigger deployments from your team chat
  • Monitor CI/CD pipelines in real-time
  • Collaborate on deployment decisions with threaded discussions

🚀 Rapid Response

  • Emergency deployments via mobile Matrix client
  • Quick rollbacks when issues arise
  • Status checks without leaving your chat

🔐 Secure Ops

  • E2E encrypted deployment commands
  • Audit trail of who triggered what
  • OIDC/SSO integration with your identity provider

🏢 Enterprise Ready

  • Self-hosted Matrix and Semaphore
  • Role-based access with Matrix permissions
  • Integrates with existing infrastructure

🌟 Getting Help

📜 License

ChatrixCD is open source under the GNU General Public License v3.0. See LICENSE for details.

Ready to automate? 🚀

Install ChatrixCD and start managing CI/CD from chat!

Get Started Now →