HEAVEN BML System
Build-Measure-Learn GitHub project management for AI agents.
Installation
pip install heaven-bml
Quick Start
# Import BML functions
from heaven_bml import (
construct_kanban_from_labels,
get_all_prioritized_issues,
move_issue_above,
move_issue_below,
create_github_issue_with_status
)
# View your kanban board
kanban = construct_kanban_from_labels('your-org/your-repo')
print(f"Backlog: {len(kanban.backlog)} items")
print(f"Plan: {len(kanban.plan)} items")
print(f"Build: {len(kanban.build)} items")
# Create a new issue with BML status
create_github_issue_with_status(
'your-org/your-repo',
'Implement feature X',
'Details about the feature',
'plan'
)
# Manage priorities with tree notation
move_issue_above('123', '456', 'your-org/your-repo')
Features
🌳 Tree Notation Priorities
- Infinite hierarchy: priority-1.2.3.4.5...
- Automatic sorting: Natural tree order in kanban
- Dynamic reordering: Move issues above/below/between
📋 GitHub Kanban States
- Backlog → Plan → Build → Measure → Learn → Archived
- Label-based: Uses GitHub labels for state management
- API integration: Real-time GitHub synchronization
🤖 MCP Server for Claude Code
# Configure Claude Desktop
python -m mcp_server --default-repo "your-org/your-repo"
🔄 GitHub Workflow Automation
# Install BML workflows in your repository
python -m heaven_bml.setup_scripts.install_bml_workflows --repo your-org/your-repo
Requirements
- Python 3.8+
- GitHub Personal Access Token with repo permissions
- Set
GITHUB_TOKENenvironment variable
License
HEAVEN BML System License
- ✅ Personal and commercial use allowed
- ✅ Modification and distribution allowed
- Required attribution: "Powered by HEAVEN BML System"
Powered by HEAVEN BML System
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
heaven_bml-2.6.1.tar.gz
(35.5 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file heaven_bml-2.6.1.tar.gz.
File metadata
- Download URL: heaven_bml-2.6.1.tar.gz
- Upload date:
- Size: 35.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7f9b9f8e75f93d92920576cd9e65950ec43fe2443153bdb0f7b1fe6254cb3fe0
|
|
| MD5 |
16264df0f14f90c96fd19f6df5d360f6
|
|
| BLAKE2b-256 |
a9d6de5dcd65a7ad9bdc7f54225d7ac50fd8f4a3a3ce9352f138e057faf2b2d6
|
File details
Details for the file heaven_bml-2.6.1-py3-none-any.whl.
File metadata
- Download URL: heaven_bml-2.6.1-py3-none-any.whl
- Upload date:
- Size: 38.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
87f9359216e416756da70f79dce6a3fa9728897a66ebfb11a64e6428f37fed87
|
|
| MD5 |
aa1a4f8ab1e0ed06383f38ac7c9a1e42
|
|
| BLAKE2b-256 |
f68218b12c056b6facfed11d4042906c963fab41b3b34f7f18cd85b2c71ae036
|
