When to choose it
A visual scene while a terminal or local Desktop Code session works.
Choose it if: You want a reactive scene and accept the optional audio or weather behavior you enable.
Look elsewhere if: You need session metrics rather than decorative scenes.
What the source describes
- Eleven scenes include aquarium, bonsai, city, train and lofi
- The /ambient picker changes scenes and saves the selection locally
- Tool and turn events animate the scene; sound is optional
Requirements
- Claude Code 2.1.287+; upstream reports testing on 2.1.287
- 24-bit terminal color recommended; at least 20 columns and 3 rows
- Sound support is documented for macOS
Install from the reviewed source
These are the source’s documented installation steps. Read the source, license and requirements first. Marketplace installation can use a different scope from a local --plugin-dir session. Restart Claude Code or use /reload-plugins afterward.
claude plugin marketplace add barisdemirhan/claude-mods
claude plugin install ambient@claude-modsUse it after installation
Run /ambient after restarting Claude Code or using /reload-plugins.
Installation and loading troubleshootingLimitations & considerations
- Optional weather sends the chosen city or time-zone city and coordinates to Open-Meteo every 15 minutes
- Settings, bonsai growth and current-day skyline persist locally
- Install from only one marketplace to avoid duplicated hooks; older rollout-flag wording is obsolete
Mods execute with your user privileges and are not sandboxed. They can access files, launch processes and make network requests. ClaudeStack has not run or security-audited this Mod. Use claude plugin validate on a downloaded directory to inspect declared behavior; validation does not certify safety. Check the official trust guidance before loading it.
Source & review record
Our description is based on public documentation and manifests available on 2026-10-05, including the hooks-module pointer and registration source. Installation formats were checked against Claude Code’s documentation. No extension code was executed: this is a source review, not a runtime compatibility test or security audit.
- Original source and documentation
- Reviewed registration source
- License of the reviewed source
- Official plugin installation documentation
Repository last pushed at the time of review: 2026-10-05T08:11:26Z. This date does not prove that the individual Mod works with a particular Claude Code release.