Gravity DSL is a textual definition language for AI-constrained enterprise software development. It declares domain entities — identity, relations, properties, lifecycle, events, and commands — in a precise, versioned, AI-readable form, and drives multi-target code generation through a pluggable emitter architecture.
The v1 proposal lives in docs/specs.md. The locked specification
for Phases 0–3 (spike, compiler core, AST publication and emitter host, C# reference
emitter) is in specs/001-gravity-dsl/spec.md, with
its implementation plan and task list as sibling files.
The build is not yet wired end-to-end; this repository is in active Phase 0 scaffolding.
gravc is the command-line compiler: it validates (gravc check) and generates
code (gravc gen) from .gravity sources. It is distributed two ways:
- Standalone single-file binaries (self-contained — no .NET runtime required), attached to each GitHub Release for Linux, macOS, and Windows (x64 + arm64).
- dotnet global tool:
dotnet tool install -g gravc(smaller download when you already have the .NET SDK).
Both distributions are functionally identical, including external --plugin
emitter support.
Install and usage instructions live in the gravc-cli skill —
skills/gravc-cli/SKILL.md.
This repo ships reusable agent skills (installable into Claude Code as a plugin or plain skill, or into OpenAI Codex):
skills/gravity-dsl/— read and write.gravitysource correctly: full grammar, canonical formatting, diagnostics, validated examples.skills/gravc-cli/— install and drive thegravcCLI.
See skills/gravity-dsl/README.md for the full
install matrix. Quick start for Claude Code (the plugin bundles both skills):
/plugin marketplace add 7Kronos/gravity
/plugin install gravity-dsl@gravity