Repository navigation
blq v1.0.0 — Stable Release
blq v1.0.0
Build Log Query — capture, store, query, and sandbox build/test logs using DuckDB.
pip install blq-cli
blq init --detect
blq run test
blq errors
blq inspect test:1:1Stability Guarantees
Starting with 1.0, the following are stable and won't change incompatibly:
- CLI command names and flags
- MCP tool names and parameters
- TOML config format
- Python API (
LogStore,LogQuery,BlqStorage, services) - BIRD schema v3.0.0 (tables, columns, macros)
- Storage directory:
.bird/ - Sandbox spec dimensions and presets
- Plugin protocols (extensions, engines, annotators)
Highlights
- 60+ log formats via duck_hunt (gcc, pytest, cargo, eslint, mypy, and more)
- Sandbox enforcement — declarative specs with bwrap namespace isolation
- MCP server — 18 tools for AI agent integration
- Plugin system — extensions, sandbox engines, and annotators via entry points
- Service layer — shared business logic, CLI and MCP always agree
- 1,304 tests
Quick Start
pip install blq-cli
cd your-project
blq init --detect # auto-detect build commands
blq run test # capture test output
blq errors # see what failed
blq sandbox profile test # discover resource usage
blq sandbox tighten test # auto-narrow sandbox spec