Skip to content

Amber CLI 2.0.7

Latest

Choose a tag to compare

@crimson-knight crimson-knight released this 06 Oct 15:29

Amber CLI 2.0.7 helps coding agents such as Claude Code and Codex write Crystal that compiles the first time, in Amber V2 apps, plain Crystal apps, and Crystal shards.

Install or upgrade

HOMEBREW_NO_AUTO_UPDATE=1 brew install amberframework/amber_cli/amber_cli
amber --version
amber-lsp --version

What's new

  • amber-lsp lookup 'Type.method' answers from your project's real code: its own source, every shard in lib/, and the Crystal standard library. It prints the signature, the resolved return type, where the method is defined, its doc comment, and notes from API cards. It falls back to stock crystal when crystal-alpha is not installed.
  • amber-lsp hint reads compiler output and prints the fix for known mistakes.
  • amber setup:agent connects Claude Code and Codex to amber-lsp in any Crystal project. It installs hooks that tell the agent to look methods up first, format each edited file, check Amber V2 rules in Amber apps, and build when the agent stops. Crystal edits are held back until amber-lsp is installed and checksum-verified.
  • amber doctor reports the same readiness checks, agent trust, and index freshness, with a fix for each failure.
  • amber-lsp --help documents every mode.
  • API cards: libraries ship notes and error hints in .amber-lsp/api/*.yml. Grant, Amber, asset_pipeline, micrate, and gemma now include cards, and the Crystal card is bundled.
  • Minecart 2025.11.25.8 is the pinned dependency manager.

In a 40-task evaluation, requiring lookup raised first-try compile rates from 85.0% to 97.5% (Sonnet) and from 62.5% to 82.5% (Haiku).

See the agent tooling guide.

Amber CLI v2.0.7

Release commit: faed4b205063a84650b00e2dc02f01793f373527

Archive SHA-256 values:

Archive SHA-256
amber_cli-source-2.0.7.tar.gz 6e90f3cdba3ed87cefbf7443ab93da627af314fac5960a4b9288ae80e31f591f
amber_cli-darwin-arm64.tar.gz: OK
amber_cli-darwin-arm64.tar.gz 0a9fb1227af6574c689eae3d2f4d83281cc3edfab3d40799079d470bb2c7ce61
amber_cli-linux-x86_64.tar.gz: OK
amber_cli-linux-x86_64.tar.gz 679b2a55b9b6ee22c73f644e41843eea2ae2ceb633ca72125620ae129133c4aa
amber_cli-linux-arm64.tar.gz: OK
amber_cli-linux-arm64.tar.gz 6b5aa8ad8b671c0f9df33850c452671925162aa794d83077684f60a0cfc8f9e4