senclaw/luna-calendar
app Lịch âm Việt Nam & xem ngày tốt xấu. Xem đầy đủ thông tin một ngày: dương lịch/âm lịch, can chi ngày–tháng–năm, tiết khí, ngày Hoàng Đạo/Hắc Đạo, giờ Hoàng Đạo/Hắc Đạo, trực, nhị thập bát tú, ngũ hành nạp âm, hướng xuất hành (Hỷ Thần/Tài Thần), xuất hành theo Lý Thuần Phong và các ngày kỵ (Nguyệt kỵ, Tam nương). Lịch tháng có chấm đánh dấu ngày tốt/xấu, đổi ngày Âm⇄Dương, và luận giải AI xem ngày có hợp việc (cưới hỏi, khai trương, xuất hành…). Thuật toán Hồ Ngọc Đức (GMT+7) — kết quả xác định, không cần mạng.
Install
senclaw app install senclaw/luna-calendar
Verifies sha512 and SenClaw’s signature before writing to disk.
Documentation
Lịch Âm · Luna Calendar 🌙
A SenClaw App Space: Vietnamese lunar calendar + "xem ngày tốt xấu" almanac. Deterministic (Hồ Ngọc Đức algorithm, GMT+7) — no network, no LLM needed for the core; an optional AI advisory layers on top.
Reference-accurate: verified against a published almanac for 7/7/2026 — 23/5 âm lịch, ngày Nhâm Ngọ, giờ Hoàng Đạo Tý · Sửu · Mão · Ngọ · Thân · Dậu, phạm Nguyệt kỵ.
Features
- Xem ngày tốt xấu hôm nay (and any date): dương/âm lịch, can chi ngày–tháng–năm, con giáp, tiết khí, ngày Hoàng Đạo / Hắc Đạo (+ vị thần), giờ Hoàng Đạo / Hắc Đạo với khung giờ, trực, nhị thập bát tú (tốt/xấu), ngũ hành nạp âm, hướng xuất hành (Hỷ Thần / Tài Thần), xuất hành theo Lý Thuần Phong, và ngày kỵ (Nguyệt kỵ, Tam nương), kèm một câu tư vấn nên làm / nên tránh.
- Lịch tháng với chấm màu: đỏ = ngày tốt (Hoàng Đạo), tím = ngày xấu (Hắc Đạo phạm kỵ); hiển thị ngày âm, đánh dấu mùng 1 âm mỗi tháng, và ngày hôm nay.
- Đổi lịch Âm ⇄ Dương (giỗ, Tết, sinh nhật), có hỗ trợ tháng nhuận.
- Luận giải AI: một ngày có hợp cưới hỏi / khai trương / xuất hành… (qua LLM của daemon).
Run (dev)
# backend (port 4351)
cargo run -p luna-calendar
# web UI (Vite, proxies /api → 4351)
cd apps/luna-calendar/web && npm install && npm run devOpen the printed Vite URL. The Rust binary alone also serves the built UI from web/dist (or the packaged web_dist) at <http://127.0.0.1:4351/>.
HTTP API
| Method | Path | Purpose |
|---|---|---|
| GET | /api/status | health + today's date |
| GET | /api/day?date=YYYY-MM-DD | full almanac for a solar date (default today) |
| GET | /api/month?year=&month= | month grid cells (lunar day + tốt/xấu verdict) |
| GET | /api/lunar-to-solar?ld=&lm=&ly=&leap= | âm → dương + almanac |
| GET | /api/good-days?year=&month=&kind= | list hoàng-đạo (or hắc-đạo) days of a month |
| POST | /api/advise {date, activity} | AI luận giải for an activity |
MCP tools (luna-mcp, HTTP/SSE at /api/mcp/sse)
luna_today— hôm nay là ngày gì, tốt hay xấu (full almanac).luna_day— xem ngày tốt xấu cho một ngày dương bất kỳ.luna_good_hours— giờ Hoàng Đạo / Hắc Đạo của một ngày.luna_solar_to_lunar/luna_lunar_to_solar— đổi lịch hai chiều.luna_good_days— liệt kê ngày tốt/xấu trong một tháng.luna_advise— luận giải AI ngày có hợp một việc.
Skill & persona
- skill
luna-xem-ngay— routes lunar/almanac questions to the MCP tools. - persona
luna-almanac-master— "Thầy Lịch Vạn Niên": grounded, calm, non-superstitious.
Package
apps/luna-calendar/scripts/pack.sh # → apps/luna-calendar/luna-calendar-app.zipAccuracy notes
Solar⇄lunar, can-chi, tiết khí, giờ hoàng đạo, ngày hoàng đạo, trực, nạp âm, ngày kỵ and the Hỷ/Tài-Thần directions follow the standard Vietnamese almanac and are unit-tested. Nhị Thập Bát Tú follows the thất-chính (7-luminary) weekday convention; the xuất-hành fortune uses the Lý Thuần Phong (Lục Diệu) system. All almanac output is a cultural reference, not deterministic fate.
Declared permissions
{
"network": [
"127.0.0.1"
],
"exec": [
"./luna-calendar"
]
}Declared by the publisher, not enforced by SenClaw. The CLI compares this against what you already have installed and asks before anything widens.
Published by
The checkmark means SenClaw confirmed who this publisher is. It says nothing about whether their packages are safe.
About
| Owner | @senclaw |
| Latest | 1.0.2 |
| Downloads | 1 |
Versions
| Version | Tags | Artifacts | Published |
|---|---|---|---|
1.0.2 | latest | darwin-arm64, linux-x64, win32-x64 | 2026-08-13 |
1.0.1 | darwin-arm64, linux-x64, win32-x64 | 2026-08-09 | |
1.0.0 | darwin-arm64, linux-x64, win32-x64 | 2026-07-20 |
Artifacts · 1.0.2
| Platform | Format | Signature | File | Size |
|---|---|---|---|---|
darwin-arm64 | zip | unsigned | luna-calendar-app.zip | 1678 KB |
linux-x64 | zip | unsigned | luna-calendar-app.zip | 1876 KB |
win32-x64 | zip | unsigned | luna-calendar-app.zip | 1856 KB |
Unsigned builds require sign-in to download and are not distributed to the auto-updater, because unsigned executables from a new domain get flagged as unsafe. Sign and notarize (macOS) or Authenticode-sign (Windows) to distribute publicly.
Auto-update endpoints
For a Tauri app — add to tauri.conf.json:
"endpoints": ["https://hub-store.bacnd.com/api/v1/updates/tauri/senclaw/luna-calendar/{{target}}/{{arch}}/{{current_version}}"]For an electron-updater app — generic provider URL:
https://hub-store.bacnd.com/updates/senclaw/luna-calendar/stable
Only signed/notarized artifacts are offered as updates — a client fetches the update without credentials, and unsigned binaries are not publicly downloadable.
Something wrong with this package?
Report this package
Report this package
Tell us what is wrong and a moderator will look at it. Be specific — a report that names a version and a behaviour can be checked in minutes; one that says “looks sketchy” cannot be acted on at all.
Not about this package? Contact us instead. What happens to a report is described in reporting and moderation.
API: GET https://hub-store.bacnd.com/api/v1/packages/senclaw/luna-calendar