proompteng/bilig

Bilig feels like a serious project solving a real pain point: using spreadsheet logic from code without having to open Excel, drive a browser, or trust stale cached formula values. The “agent-first workbook” framing is strong because it explains the project’s personality clearly: Bilig is for services, tests, and AI tools that need to edit inputs, recalculate formulas, read results back, and prove that the work actually happened.

What stood out most is how much care has gone into trust and maintainability. The repo has active releases, a large commit history, CI workflows, MIT licensing, security and contributing docs, examples, tests, and a clear monorepo structure. The README is also unusually specific: it points users toward @bilig/workbook, @bilig/workpaper, XLSX recalculation packages, SheetJS/ExcelJS bridges, MCP tooling, and compatibility docs instead of just giving a vague sales pitch.

My main suggestion is to make the first-time path gentler. The README is packed with useful information, but it can feel like a lot at once. A shorter “start here” section with three simple paths would help: “I have an XLSX,” “I want a headless workbook in Node,” and “I want an agent/tool contract.” That would make the project easier to try before readers understand the whole architecture.

Overall, Bilig comes across as thoughtful, practical, and well maintained. It has a clear niche, real technical depth, and good contributor signals. The next big win is probably less about adding more information and more about helping new users find the right doorway faster.