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
- Stack
- Features
- Atajos de Teclado
- Instalación
- Configuración
- FAQ
- Publicación y Versionado
- Licencia
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:
- CI corre lint + verifica que el paquete importe correctamente
- Ejecutar
bash publish.shpara 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.