About gitstream

/:\ gitStream - Workflow automation for your git repo. Use YAML to auto-assign reviewers, auto-merge PRs, automatic PR labeler, and more.

l

Published by

linear-b

Visit View Profile

README.md

View on GitHub

The ultimate workflow automation tool for your git repository

/:\ gitStream makes it simple to auto-assign reviewers, automate CI services, add important context, unblock PR/MR reviews, and more.

Explore the docs »

Report Bug · Request Feature · Share your automation · Feature Updates

⭐️ Why gitStream?

Our research shows that code reviews are the most consistent bottleneck in the software development process, so we built gitStream to enable dev teams to use simple YAML configurations to reduce code review toil and improve software quality.

✨ Features

🤓 Auto-assign PR/MR reviewers
♾️ Selectively trigger CI pipelines
🔃 Send webhooks from your git repo to other tools like Slack, Jira, and more
✅ Auto-merge low-risk PRs/MRs like documentation, dependency updates, and test additions
🏷️ Automatic PR labeler
🔌 Build custom JavaScript plugins to extend functionality for more advanced data processing and pulling data from external APIs.
‼️ Flag problems before requesting human review
💬 Add context to code reviews with comments and labels

Auto-approve safe change

🚀 Get Started

gitStream is a GitHub / GitLab / Bitbucket app that processes automations defined in Continuous Merge (CM) automation files contained in your git repos. You can test gitStream automations on your own PRs via the gitStream playground.

If you're ready to install gitStream, or want to explore its automation capabilities, head over to the docs. You can have your first automation up and running in as little as 2 minutes.

📣 Updates

Subscribe to gitStream Feature Announcements.

📁 Local Documentation Server Setup

This repository supports two documentation systems:

MkDocs (Production/Default)

The production documentation system, used by CI/CD. Requires Python 3.12 (or ≤3.10).

# Create and activate virtual environment
python3.12 -m venv .venv
. .venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Run server
mkdocs serve  # http://127.0.0.1:8000/

Zensical (Experimental)

An alternative documentation system being evaluated. Requires Python 3.11+

# Install dependencies (creates .venv-zensical automatically)
UV_PROJECT_ENVIRONMENT=.venv-zensical uv sync

# Run server
UV_PROJECT_ENVIRONMENT=.venv-zensical uv run zensical serve  # http://127.0.0.1:8000/

Note: Both servers use port 8000, so run only one at a time.

LinearB

gitStream is a free product from the team at LinearB: the industry-leading platform for software delivery management that has helped thousands of developers around the world improve their team's productivity.

gitstream