NepKal

SYSTEM
MANUAL

NepKal is a high-performance command-line utility designed for the modern developer. Engineered in Rust/Python, it provides tactical Bikram Sambat integration directly into your shell buffer.

Installation_Matrix

Choose your operating environment for deployment

macOS / Linux
Shell_Script
curl -fsSL https://nepkal.vercel.app/install.sh | sh
Windows
PowerShell
iwr -useb https://nepkal.vercel.app/install.ps1 | iex

Operational_Logic

Master the command hierarchy

Temporal Visualization

$ nepkal cal

Render the current month's grid buffer

$ nepkal marks

Track and visualize day-marked cycles

$ nepkal dash

Premium telemetry summary of current state

$ nepkal year

Visualize the entire 12-month annual cycle

Memory Persistence (Marks & Pins)

$ nepkal pins

List all persistent temporal markers

$ nepkal pin [date] [label]

Anchor a BS date to the system buffer

$ nepkal mark [date] [note]

Mark a manual timestamp for tracking

$ nepkal select [index]

Select a pin for calendar spotlight

$ nepkal unmark [date]

Remove a manual tracking marker

Data Conversion

$ nepkal conv tobs [yyyy-mm-dd]

Translate AD temporal units to BS

$ nepkal conv toad [yyyy-mm-dd]

Translate BS temporal units to AD

Designer_Intent

The philosophy behind the monolith

"Namaste! I'm a regular developer who loves to craft tools by myself. NepKal started as a weekend project to solve a personal itch: checking the Nepali date without opening a heavy browser tab or phone app."

Dev Raj Khadka | Nepkal Developer