Ledge.sh – Khi ghi chú Markdown có thể chạy lệnh terminal và truy vấn SQL

Nếu bạn từng mệt mỏi vì phải liên tục copy lệnh từ ghi chú rồi dán vào terminal, Ledge.sh có thể là công cụ dành cho bạn. Đây là một sổ tay Markdown cho phép chạy trực tiếp lệnh shell, code và truy vấn SQL ngay trong chính trang ghi chú của mình.

Dự án vừa được giới thiệu trên Hacker News, được phát triển từ tháng 7 và hiện đã hỗ trợ hầu hết các nền tảng chính. Công cụ này miễn phí, mã nguồn mở và hướng tới những người làm kỹ thuật, DevOps hay lập trình viên muốn gộp ghi chú với công việc thực thi hàng ngày.

Vấn đề mà Ledge giải quyết

Tác giả chia sẻ rằng ông dành phần lớn thời gian trong ngày để copy lệnh từ ghi chú rồi dán vào terminal. Dù các công cụ quản lý terminal như cmux giúp tổ chức cửa sổ dòng lệnh tốt hơn, vẫn tồn tại tình trạng "chia đôi bộ não" giữa ghi chú và những lệnh chạy thường xuyên.

Ledge ra đời để xóa bỏ khoảng cách đó: ghi chú không chỉ để đọc mà còn chạy được ngay tại chỗ.

"Tôi đã dùng nó hàng ngày trong vài tuần qua cho việc triển khai, gọi API, kiểm thử nhanh và nhiều tác vụ khác."

Cách hoạt động

Ledge vận hành shell thật giống như một ứng dụng terminal, không phải môi trường giả lập. Người dùng có thể khởi chạy cục bộ hoặc từ xa qua SSH thông qua ledge-server.

Một điểm đáng chú ý là kết quả thực thi được hiển thị ngay trong ghi chú, chẳng hạn:

• Chạy truy vấn SQL và nhận bảng kết quả trực tiếp:

select plan, count(*)
from signups group by plan;

Kết quả trả về trong khoảng 41 ms:

plan | count
-----+-------
free |  1204
pro  |   187

• Hoặc chạy code Python để phân tích dữ liệu:

import pandas as pd
df = pd.read_csv("signups.csv")
print(df["source"].mode()[0])

Kết quả: newsletter, hoàn tất trong 610 ms.

Nền tảng được hỗ trợ

Ledge hiện chạy được trên hầu hết hệ điều hành phổ biến:

• macOS (chip Apple Silicon)
• Windows (yêu cầu WSL)
• Linux
• iOS
• Android (vẫn đang ở giai đoạn beta và đang tìm người thử nghiệm)

Trên thiết bị di động, ứng dụng cần quyền truy cập SSH vào một ledge-server mới hoạt động được.

Công nghệ và giấy phép

Dự án được xây dựng trên Bun và Electrobun, hoàn toàn miễn phí và mã nguồn mở. Mã nguồn có sẵn tại GitHub để cộng đồng xem xét và đóng góp.

Góc nhìn cho người dùng Việt Nam

Với các đội kỹ thuật tại Việt Nam thường xuyên làm việc với DevOps, kiểm thử API hay quản lý cơ sở dữ liệu, một công cụ gộp ghi chú và thực thi lệnh như Ledge có thể giúp tiết kiệm đáng kể thời gian chuyển đổi ngữ cảnh. Việc hỗ trợ SSH từ xa cũng phù hợp với mô hình làm việc trên server hoặc máy chủ cloud — vốn rất phổ biến trong các dự án phần mềm hiện nay.

Tuy nhiên, cần lưu ý rằng chạy lệnh trực tiếp trong ghi chú đòi hỏi ý thức bảo mật cao, đặc biệt khi ghi chú được chia sẻ hoặc đồng bộ. Người dùng nên cân nhắc kỹ trước khi lưu các lệnh nhạy cảm hoặc thông tin xác thực trong cùng một tệp.

Nếu bạn quan tâm, hãy thử Ledge và gửi phản hồi cho tác giả — đặc biệt là các tính năng mà bạn cho là bắt buộc phải có.