Editor support for Kul — a small declarative language for kinship and family-tree data.

Highlighting preview

Open a .kul file and you get diagnostics, hover docs, format-on-save, go-to-definition, completion, and outline — all powered by the bundled Kul language server. No setup required.

Features

Live diagnostics for all 13 Kul validation rules — duplicates, unresolved references, temporal contradictions, parenthood cycles
Hover docs on keywords, fields, and identifiers
Go-to-definition, find-all-references, rename
Completion for keywords, field names, enum values, and existing person/marriage ids
Format-on-save via the canonical kul format pass
Document outline of persons, marriages, and their nested birth/adoption sub-statements
Quick fixes for missing required fields and end-consistency violations
Snippets for kul, person, marriage, birth, adoption
Export commands — Kul: Export to JSON and Kul: Export to Cytoscape JSON from the command palette: projects the current document (including unsaved edits) to canonical JSON. The Cytoscape form drops into Cytoscape.js, Sigma.js, vis-network, and similar graph-layout libraries

Settings

kul.serverPath — absolute path to a custom kul-lsp binary. Leave empty to use the bundled one.
kul.trace.server — off / messages / verbose. Surfaces LSP traffic in the Kul LSP output channel.

Requirements

VSCode 1.85 or later — installs from the VS Code Marketplace — or any Open VSX consumer (VSCodium, Cursor, Windsurf, Theia, Gitpod, Kiro) on the same version floor.

Feedback and bug reports

File issues at github.com/YashBhalodi/kul/issues — bugs, language proposals, and editor-feature requests all go there. Please skim the language spec and examples before filing a language proposal.

AI authoring is separate

If you're looking for AI-assisted .kul authoring, that's delivered as a separate agentskills.io-compliant skill — not as a VSCode command. This extension is the tooling surface (diagnostics, formatting, export); the kul-authoring skill is the authoring surface for LLM agents. Install it into your project with npx skills add YashBhalodi/kul --skill kul-authoring and any agentskills.io-compliant agent (Claude Code, Cursor, Copilot, Codex CLI, Gemini CLI, …) will pick it up.