bitbucket-cli 0.1.0

A powerful command-line interface for Bitbucket Cloud - manage repos, PRs, issues, and pipelines from your terminal
bitbucket-cli-0.1.0 is not a library.
Visit the last successful build: bitbucket-cli-0.3.3

Bitbucket CLI

CI Release Crates.io License: MIT

A powerful command-line interface for Bitbucket Cloud. Manage repositories, pull requests, issues, and pipelines directly from your terminal.

✨ Features

  • 📁 Repository Management - List, view, clone, create, and manage repositories
  • 🔀 Pull Requests - Create, review, merge, approve, and manage PRs
  • 🐛 Issue Tracking - Create, view, comment on, and manage issues
  • ⚡ Pipelines - Trigger, monitor, and manage CI/CD pipelines
  • 🖥️ Interactive TUI - Beautiful terminal UI for browsing and managing resources
  • 🔐 Secure Authentication - App passwords and OAuth with secure keyring storage

📦 Installation

Using Cargo (Recommended)

cargo install bitbucket-cli

From Source

git clone https://github.com/pegasusheavy/bitbucket-cli.git
cd bitbucket-cli
cargo install --path .

Pre-built Binaries

Download pre-built binaries from the Releases page.

🚀 Quick Start

1. Authenticate

bitbucket auth login

You'll be prompted to enter your Bitbucket username and app password. Create an app password with the required permissions.

2. Start Using

# List repositories
bitbucket repo list myworkspace

# View a repository
bitbucket repo view myworkspace/myrepo

# List pull requests
bitbucket pr list myworkspace/myrepo

# Create a pull request
bitbucket pr create myworkspace/myrepo --title "My PR" --source feature-branch

# Launch interactive TUI
bitbucket tui --workspace myworkspace

📖 Commands

Command Description
bitbucket auth Manage authentication (login, logout, status)
bitbucket repo Manage repositories (list, view, clone, create, fork, delete)
bitbucket pr Manage pull requests (list, view, create, merge, approve, decline)
bitbucket issue Manage issues (list, view, create, comment, close, reopen)
bitbucket pipeline Manage pipelines (list, view, trigger, stop)
bitbucket tui Launch interactive terminal UI

🖥️ TUI Mode

Launch the interactive terminal UI for a visual way to browse and manage your Bitbucket resources:

bitbucket tui

Keyboard shortcuts:

  • q - Quit
  • 1-5 - Switch views (Dashboard, Repos, PRs, Issues, Pipelines)
  • j/k or ↑/↓ - Navigate
  • Enter - Select/Open
  • r - Refresh

⚙️ Configuration

Configuration is stored in ~/.config/bitbucket/config.toml:

[auth]
username = "your-username"
default_workspace = "your-workspace"

[defaults]
branch = "main"

[display]
color = true
pager = true

📚 Documentation

Full documentation is available at pegasusheavy.github.io/bitbucket-cli

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

💖 Support

If you find this project useful, please consider:

Made with ❤️ by Pegasus Heavy Industries