gitflow-cli
Cross-platform Git engineering workflow orchestration tool — manage Issues, PRs, Releases, and CI/CD pipelines across GitHub, GitLab, and GitCode from a unified CLI.
Overview
gitflow-cli is a powerful command-line tool that provides a unified interface for managing Git hosting platforms. Whether you're working with GitHub, GitLab, or GitCode, gitflow-cli offers consistent commands for issue tracking, pull requests, releases, and more.
Features
- Multi-Platform Support: GitHub, GitLab, and GitCode with a single CLI
- Issue Management: Create, list, view, and manage issues
- Pull Requests: Create, review, merge, and manage PRs/MRs
- Release Management: Create releases with auto-generated changelogs
- Code Reviews: Submit and manage code reviews
- Pipeline Monitoring: Check CI/CD pipeline status
- Authentication Checking: Verify platform authentication status
- Shell Completions: Auto-completion for bash, zsh, and fish
- JSON Output: Machine-readable output for scripting
Installation
From crates.io
From GitHub Releases
Download pre-built binaries from the releases page:
# macOS (Apple Silicon)
# macOS (Intel)
# Linux (x86_64)
From Source
Quick Start
Check Authentication
# Check if authenticated to platforms
Issue Management
# List open issues
# Create a new issue
# View issue details
Pull Request Management
# List open PRs
# Create a new PR
# Review a PR
Release Management
# List releases
# Create a new release
Pipeline Status
# Check pipeline status
Commands
auth — Authentication
issue — Issue Management
pr — Pull Request Management
release — Release Management
review — Code Review
pipeline — CI/CD Pipelines
completions — Shell Completions
Platform Support
| Feature | GitHub | GitLab | GitCode |
|---|---|---|---|
| Issues | ✅ | ✅ | ✅ |
| Pull Requests | ✅ | ✅ (MRs) | ✅ |
| Releases | ✅ | ✅ | ✅ |
| Reviews | ✅ | ✅ | ✅ |
| Pipelines | ✅ | ✅ | ✅ |
| Authentication | ✅ (gh) | ✅ (glab) | ✅ (gc) |
Configuration
gitflow-cli uses platform-specific CLIs for authentication:
Install and authenticate with the appropriate CLI for your platform.
Environment Variables
GITHUB_TOKEN/GH_TOKEN— GitHub authentication tokenGITLAB_TOKEN— GitLab authentication tokenGITCODE_TOKEN— GitCode authentication tokenGITFLOW_PLATFORM— Force specific platform (github/gitlab/gitcode)
Shell Completions
Auto-completion is available for bash, zsh, and fish:
# Install completions
# Or manually generate
JSON Output
Use --json flag for machine-readable output:
Architecture
┌─────────────────────────────────────────┐
│ gitflow-cli (CLI) │
└──────────────────┬──────────────────────┘
│ uses
▼
┌─────────────────────────────────────────┐
│ gitflow-cli-core (traits) │
└──────────────────┬──────────────────────┘
│ implementations
┌──────────┼──────────┐
▼ ▼ ▼
┌────────┐ ┌────────┐ ┌────────┐
│ GitHub │ │ GitLab │ │GitCode │
└────┬───┘ └────┬───┘ └────┬───┘
│ │ │
▼ ▼ ▼
gh CLI glab CLI gc CLI
Ecosystem
This crate is part of the gitflow-cli workspace:
- gitflow-cli-core — Core types and traits
- gitflow-cli-github — GitHub platform implementation
- gitflow-cli-gitlab — GitLab platform implementation
- gitflow-cli-gitcode — GitCode platform implementation
- gitflow-cli (this crate) — CLI application
Documentation
Contributing
Contributions are welcome! Please see the main repository for contribution guidelines.
License
Licensed under the MIT License. See LICENSE for details.