Mint language

Mint is the governed automation language for expressing what an engineering system should accomplish. SpecMint turns that intent into an approved, observable, verifiable lifecycle. Integrations connect Mint capabilities to repositories, clouds, Kubernetes, SaaS platforms, and internal systems without moving execution authority into the language.

This repository is the public language extract: grammar, MintIR, reference compiler, CLI (mint), Integration Protocol v0, conformance suite, and VS Code extension.

Public preview / alpha.2 — not production-ready, not 1.0.

SpecMint Platform is the governed runtime. The hosted SpecMint service stays private. opsdevcode/specmint remains internal. There is no mint apply command. There are no live providers or credentials here.

Product page: opsdevco.de/products/mint

Install

pipx install specmint
mint version

uv tool install specmint
mint version

The distribution name is specmint. The language executable is mint. A thin specmint mint … alias forwards to the same language CLI.

Until the PyPI trusted publisher is registered, install the exact GitHub Release wheel (checksums on the release):

pipx install specmint==0.1.0a2 --index-url https://pypi.org/simple
# or, from the GitHub Release asset:
# pipx install ./specmint-0.1.0a2-py3-none-any.whl
# uv tool install ./specmint-0.1.0a2-py3-none-any.whl

Alpha version: 0.1.0a2 (Git tag v0.1.0-alpha.2). Do not use a latest tag; none is published.

Five-minute quickstart

See docs/quickstart.md. Copy examples/projects/local-marker, then check, fmt --check, lock, compile, inspect, plan, and mint integrations conformance. SpecMint begins after that plan: approval, fake/local execution, verification, and evidence. No credentials. No live mutation.

Headline: Integration Protocol v0

Mint capabilities remain the promise. Integrations realize capabilities for targets. A realization is a resolved binding, not a downloadable package. Planning never grants execution authority.

• Integration Protocol
• Authoring an integration
• Trust and permissions
• ADR 018

mint adapters is a deprecated alpha alias of mint integrations.

Language commands

check compile convert fmt inspect init lock lsp plan project integrations adapters repository version

compile emits canonical MintIR. plan is snapshot-driven and offline. mint apply is not implemented.

Documentation

• Language overview
• Why Mint is not Terraform
• Project and lock model
• MintIR
• Editor / LSP
• Compatibility policy
• Public roadmap boundaries
• Conformance
• Security reporting
• Contributing
• Docs index

VS Code

Publisher id: opsdevcode.mint-language. GitHub Releases attach the VSIX built for this tag. Marketplace and Open VSX publish require the OpsDevCode publisher identity.

License

Apache License 2.0. See LICENSE and NOTICE.