Repository navigation
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 --versionWhat's new
amber-lsp lookup 'Type.method'answers from your project's real code: its own source, every shard inlib/, 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 stockcrystalwhencrystal-alphais not installed.amber-lsp hintreads compiler output and prints the fix for known mistakes.amber setup:agentconnects Claude Code and Codex toamber-lspin 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 untilamber-lspis installed and checksum-verified.amber doctorreports the same readiness checks, agent trust, and index freshness, with a fix for each failure.amber-lsp --helpdocuments 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 |