Skip to main content

CI Python License Version

Bitbucket Manager

Suite TUI para administración de Bitbucket Cloud desde la terminal. Navegación 100% por teclado, multiplataforma, instalable vía pipx, pip o Homebrew.

Creado por Alan Stefanov — LinkedIn


Tabla de Contenidos


Visión

Administrar Bitbucket Cloud desde la terminal, sin tocar el navegador:

Feature Estado
Dashboard de workspace ✅
Explorador + clonado de repos ✅
Gestión masiva de permisos ✅
Gestión de grupos y miembros ✅
Miembros del workspace ✅
Migración entre proyectos ✅
Archivado inteligente ✅
Análisis de dependencias ✅
Publicación (PyPI, Homebrew) ✅
Auto-aprobación masiva de PRs 🚧

Stack

Capa Librería
TUI Framework Textual 8.x — async, CSS-like styling, 24-bit color
HTTP / API requests — cliente REST para Bitbucket Cloud API v2.0
YAML pyyaml — reglas de PR, archivado, dependencias
Terminal enhancements rich — logging, tablas, progreso
Distribución pyproject.toml → PyPI / pipx / Homebrew

Features

👥 Grupos

  • Listar todos los grupos del workspace
  • Crear y eliminar grupos
  • Agregar o remover miembros de un grupo

👤 Miembros

  • Listar todos los miembros del workspace
  • Ver display name, nickname y account ID

📊 Dashboard

  • Métricas del workspace: total de repos, PRs abiertos, activida reciente

📦 Repos

  • Explorar repositorios del workspace
  • Clonar, pull y checkout desde la TUI

🔐 Permisos

  • Listar permisos de usuarios y grupos por repositorio
  • Otorgar y revocar permisos

✅ PRs

  • Listar PRs abiertos
  • Auto-aprobar PRs

📋 Migración

  • Migrar repositorios entre workspaces manteniendo historial git

🗄️ Archive

  • Archivar repositorios inactivos según reglas configurables

🔗 Deps

  • Analizar dependencias entre repos del workspace

Atajos de Teclado

Pantalla de inicio (Home)

Tecla Acción
↑ / ↓ Navegar entre cards
← / → Navegar entre cards
Tab / Shift+Tab Navegar entre cards
Enter / Space Abrir pantalla seleccionada
D Dashboard
R Repos
G Grupos
I Miembros
P Permisos
U PRs
M Migración
A Archive
S Dependencias
Q / Esc / Ctrl+Q Salir

Pantallas de feature

Tecla Acción
H / Esc Volver al menú principal
Ctrl+Q Salir de la app

Instalación

pipx (recomendado)

pipx install bitbucket-manager
bitbucket-manager

pip

pip install bitbucket-manager
bitbucket-manager

Homebrew (futuro)

brew install alanstefanov/tap/bitbucket-manager

One-liner (curses ligero)

bash <(curl -fsSL https://github.com/AlanStefanov/bitbucket-manager/raw/main/install.sh)

Configuración

La primera vez que ejecutes la app, te mostrará una pantalla interactiva para ingresar las credenciales.

O podés crear un archivo ~/.config/bitbucket-manager/env:

BB_USERNAME=tu-email@example.com
BB_TOKEN=tu_api_token
BB_WORKSPACE=mi-workspace
DEV_DIR=/home/tu/Documents/bitbucket-repos

Variables requeridas:

Variable Descripción
BB_USERNAME Email de Atlassian
BB_TOKEN API Token desde https://id.atlassian.com/manage-profile/security/api-tokens
BB_WORKSPACE Workspace de Bitbucket (ej: mi-empresa)
DEV_DIR Directorio para clones (defecto: ~/Documents/bitbucket-repos)

Ejecución desde el repo

./run.sh

FAQ


Publicación y Versionado

Versionado Semántico

bitbucket-manager sigue SemVer: MAJOR.MINOR.PATCH.

La versión se define en src/bitbucket_manager/__init__.py y se refleja en pyproject.toml.

Release

Al hacer merge de un PR a main:

  1. CI corre lint + verifica que el paquete importe correctamente
  2. Ejecutar bash publish.sh para publicar a PyPI y Homebrew

Licencia

MIT — Alan Stefanov, 2026.

Metadata

Release files for bitbucket-manager 0.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for bitbucket-manager 0.5.0
File Interpreter ABI Platform Actions
bitbucket_manager-0.5.0-py3-none-any.whl Python 3 none any Details for bitbucket_manager-0.5.0-py3-none-any.whl

Release files / bitbucket_manager-0.5.0-py3-none-any.whl

Download URL bitbucket_manager-0.5.0-py3-none-any.whl
Size 32.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c2d44ad5139fccb05bebdf0ea5af240ade2428ab83841a45eae4107a1f5e0807
BLAKE2b-256 checksum
How to use checksums
4d963a4a20513ded340272622d50c180812a00f43e682ad96b9b0da686e75c72
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.6

Security for bitbucket-manager 0.5.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page