hledger-lsp

README

hledger-lsp

A Language Server Protocol (LSP) implementation for hledger journal files. Provides IDE features like completions, diagnostics, formatting, and more for any LSP-compatible editor.

🎯 Features

Completions

• Accounts — Fuzzy matching with frequency-based ranking
• Payees — With transaction templates (auto-inserts postings)
• Commodities — From directives and usage
• Tags — Name and value completion from existing tags
• Dates — today/yesterday/tomorrow + historical dates from file

Navigation

• Go to Definition — Jump to account/commodity/payee declaration
• Find References — Find all usages across workspace

Diagnostics

• Real-time validation of transactions
• Balance checks and syntax errors

Other

• Formatting — Automatic alignment of amounts
• Hover — Account balances on hover
• Semantic Tokens — Syntax highlighting
• Document Symbols — Outline navigation
• Include Support — Multi-file journals with cycle detection

📦 Installation

From Releases

Download the latest binary for your platform from GitHub Releases.

# macOS (Apple Silicon)
curl -L https://github.com/juev/hledger-lsp/releases/latest/download/hledger-lsp_darwin_arm64 -o hledger-lsp
chmod +x hledger-lsp
sudo mv hledger-lsp /usr/local/bin/

# macOS (Intel)
curl -L https://github.com/juev/hledger-lsp/releases/latest/download/hledger-lsp_darwin_amd64 -o hledger-lsp
chmod +x hledger-lsp
sudo mv hledger-lsp /usr/local/bin/

# Linux (x86_64)
curl -L https://github.com/juev/hledger-lsp/releases/latest/download/hledger-lsp_linux_amd64 -o hledger-lsp
chmod +x hledger-lsp
sudo mv hledger-lsp /usr/local/bin/

From Source

go install github.com/juev/hledger-lsp/cmd/hledger-lsp@latest

Verify Installation

hledger-lsp --version

🚀 Quick Start

1. Install hledger-lsp (see above)
2. Configure your editor (see below)
3. Open a .journal or .hledger file
4. Start typing and enjoy completions!

2024-01-15 * grocery store
    expenses:food  $50.00
    assets:cash

🔧 Editor Setup

• VS Code
• Neovim
• Emacs

⚙️ Configuration

See docs/configuration.md for supported settings and defaults.

⚙️ Supported Features

Feature	Status
Completions	✅
Diagnostics	✅
Formatting	✅
Hover	✅
Semantic Tokens	✅
Document Symbols	✅
Go to Definition	✅
Find References	✅

📚 Resources

• hledger Documentation
• LSP Specification

📄 License

MIT © Denis Evsyukov