feat: add bell_on_completion config option#1218
Closed
gitt510 wants to merge 3 commits intoMoonshotAI:mainfrom
Closed
feat: add bell_on_completion config option#1218gitt510 wants to merge 3 commits intoMoonshotAI:mainfrom
gitt510 wants to merge 3 commits intoMoonshotAI:mainfrom
Conversation
Play bell sound when agent turn completes. This helps users notice when kimi-code finishes processing, especially useful in tmux where window-bell-style can highlight the active window. - Add bell_on_completion config option (default: true) - Pass config through visualize -> _LiveView - Play bell on TurnEnd when enabled
- Update test_default_config_dump to include bell_on_completion - Add test_visualize_bell.py with tests for TurnEnd bell behavior
Author
|
I'm closing this PR because I've determined that ringing the bell at turn-end, in addition to the existing user action events where the bell is already defined, would compromise the uniqueness of the event. |
This was referenced Mar 2, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why / Background
When using terminal multiplexers like tmux, there was no way to detect when the AI agent finished processing while working in another window.
Both Codex CLI and Claude CLI have a feature to play a bell character (
\a) when the agent completes processing, but Kimi CLI lacked this functionality.This PR adds the ability to play a bell sound when an agent's turn completes, allowing users to be notified of processing completion even when Kimi is running in the background.
What / Changes (Summary)
Code Changes
src/kimi_cli/config.py): Addedbell_on_completionconfig option (default:true)src/kimi_cli/ui/shell/):visualize.py: Modified to passconfigto_LiveViewreplay.py: Play bell onTurnEndwhenbell_on_completionis enabled__init__.py: Added config initializationTests
test_default_config_dumpto includebell_on_completiontest_visualize_bell.pywith tests for:bell_on_completion=Truebell_on_completion=FalseTrueDocumentation (auto-generated via
make gen-docs)config-files.md(en/zh) with newbell_on_completionoptionNot in scope / Out of scope
Impact / Affected areas
bell_on_completionoption can be added to~/.kimi/config.tomltrue)window-bell-styleor similar settingsRisk・Mitigation / Risks and mitigations
bell_on_completion = false\a(BEL character) is an ANSI standard and supported by virtually all terminalsTesting / Verification
window-bell-styledetects completionbell_on_completion = falsedisables the belltrue) works as expectedDiff breakdown / Summary
Checklist
make gen-docsto update the user documentation.