Claude Ambient: scenes and sound for Claude Code.
Install Claude Ambient for eleven reactive scenes above your Claude Code prompt. Learn scene controls, macOS sound setup and marketplace choices.
What it does
Barış Demirhan’s ambient mod turns Claude Code tool activity into an aquarium, bonsai, city, stars, weather, train, Game of Life, pulse monitor, fireplace, digital rain or lofi desk. The author describes visuals driven by tool-call types, failures and turn boundaries, with optional synthesized sound.
- Eleven scenes selected with /ambient
- Optional scene loops and tool-activity sounds
- Persistent bonsai, daily skyline and scene settings
- Adjustable band height, visibility and shuffle
Install Claude Ambient: which marketplace?
Read Barış Demirhan’s original README, then run the author’s current shell commands:
claude plugin marketplace add barisdemirhan/claude-mods
claude plugin install ambient@claude-modsRestart Claude Code and type /ambient to open the picker. Inside a session, the equivalent commands begin with /plugin marketplace add and /plugin install. For a missing command or band, follow the mod loading and display checklist. The author documents terminal and Desktop rendering; that does not establish this mod’s behavior on every other surface.
Do I need to replace ambient@claude-ambient?
No. The README says the original marketplace still receives updates. The newer ambient@claude-mods shares a marketplace with the author’s other mods, but Claude Code treats it as a separate install with an empty store. Keep only one active install: the author warns that both will run every hook twice.
If you choose to move, follow the README’s backup and store-copy procedure with all Claude Code sessions closed. Its example store filenames are specific to Claude Code 2.1.288 and may change. Existing scene settings, bonsai growth and today’s skyline are reasons to check the migration instructions before uninstalling.
Choose a scene and turn sound on or off
Use /ambient aquarium for tool calls represented as fish, /ambient lofi for a desk with a sleeping cat, or /ambient list to see all eleven scenes and current settings. The author also provides a browser scene-and-sound preview. That preview is separate from installing the plugin.
Sound starts off. /ambient sound on enables the scene’s loop and short activity cues; /ambient sound off disables them. Use /ambient volume 30 to set volume on the documented 0–100 scale. The README requires macOS for audio; on other systems it describes silent scenes. Sound is synthesized for the mod rather than streamed from a music service.
How do I hide the band or make it smaller?
/ambient rows 3 sets its height to three rows; the supported range is 3–10. /ambient when working shows it only while Claude works. /ambient off hides the band and stops counting and sound, leaving a control row; /ambient close removes that row too. /ambient on brings it back. The author says these visibility changes reach other open sessions within two seconds.
The author requires at least 20 columns and three rows for the band, and recommends 24-bit color. Pointer controls require a supported layout; typed commands are useful when those buttons are unavailable. These are source-documented requirements, not CC Mods compatibility tests.
Weather, saved settings and external requests
By default, the weather scene reflects tool activity. /ambient weather London asks it to follow real weather for a place; /ambient weather auto uses the city named by the machine’s time zone. The author says this sends the place name for geocoding and then its coordinates to Open-Meteo every fifteen minutes. /ambient weather off stops those requests. This differs from Token Weather’s context-window monitor.
The README says scene settings, the selected place and coordinates, bonsai growth and the day’s skyline live in Claude Code’s local plugin store. It describes reading tool names and failure status, rather than tool arguments or results. Command output such as /ambient list enters the conversation and can include the selected place. Read the author’s privacy policy for details and removal instructions.
Source reviewed October 21, 2026 at plugin version 0.4.3. Installation, audio, persistence and data-flow descriptions come from the author; CC Mods has not run or security-audited the mod.
When this mod might be useful
Claude Ambient fits a long coding session when you want a visual rhythm tied to tool activity rather than another task dashboard. Start with a scene such as aquarium or lofi, leave sound off if you prefer quiet, and show the band only while Claude works to reclaim space between turns. Its weather scene is different from Token Weather’s context monitor: real-world weather is optional and makes external requests.
Understanding this listing
Use this listing as a starting point for comparing the author’s documented behavior with your own workflow. The repository is the source of truth for installation, configuration, and later changes. The commands here reflect the setup available at the review date.
Before you try it
- Source reviewed at ambient 0.4.3 on October 21, 2026; no mod code installed or executed by CC Mods.
- The author documents terminal/Desktop rendering and macOS-only sound; this is not a per-surface compatibility test.
- Existing ambient@claude-ambient installations remain supported. Keep only one marketplace installation active to avoid running hooks twice.