A GitHub CLI-like tool for Backlog project management system.
bl provides a command-line interface for Backlog that replicates the user experience of GitHub CLI (gh). It brings issues, pull requests, wikis, and other Backlog concepts to the terminal.
- 🚀 GitHub CLI-like command structure
- 📋 Comprehensive issue management
- 🔄 Pull request operations
- 📚 Wiki management
- 🗂️ Project navigation
- 🎨 Multiple output formats (table, JSON, CSV)
- 🤖 Interactive mode for complex operations
- 🔐 Secure authentication with API keys
brew install blgo install github.com/yourusername/bl@latestDownload the latest release from the releases page.
# Login to your Backlog space
bl auth login
# Check authentication status
bl auth status# List issues assigned to you
bl issue list --assignee @me
# View issue details
bl issue view PROJ-123
# Create a new issue interactively
bl issue create
# List pull requests
bl pr list --state open
# View project information
bl project view PROJbl <resource> <action> [flags]
auth- Authentication managementissue- Issue operationspr- Pull request managementproject- Project informationwiki- Wiki pagesrepo- Git repository managementconfig- Configuration management
Configuration file is located at ~/.config/bl/config.yml:
spaces:
default: myspace
myspace:
api_key: your-api-key
space_key: myspace
default_project: PROJ
format: table
editor: vim# List all open issues in a project
bl issue list --project PROJ --state open
# Create issue with specific parameters
bl issue create --title "Bug fix" --project PROJ --type bug --priority high
# Add comment to an issue
bl issue comment PROJ-123 --body "Working on this"
# Close an issue
bl issue close PROJ-123 --comment "Fixed in PR #456"# List your pull requests
bl pr list --assignee @me
# Create a pull request
bl pr create --title "Feature: Add new API" --base main --head feature/new-api
# Review a pull request
bl pr review 123 --approve
bl pr review 123 --request-changes --body "Please update tests"
# Merge a pull request
bl pr merge 123 --squash- Go 1.21 or later
- Make
git clone https://github.com/yourusername/bl.git
cd bl
make buildmake testPlease read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.
This project is licensed under the MIT License - see the LICENSE file for details.
- Inspired by GitHub CLI
- Built with Cobra and Viper
- Uses backlog Go client library