Skip to content

steadymoka/murmur

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

60 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

murmur

Terminal companion for AI coding sessions.

License: MIT Rust

Murmur wraps your terminal in a thin PTY layer that detects AI coding tools (Claude Code, Codex) and pins your prompts as a persistent context bar. No mode switching, no screen takeover — just a quiet hint bar until an AI session starts.

Features

  • Prompt pinning — Automatically captures prompts entered inside AI tools as a navigable history bar
  • Smart capture — Recognizes slash command expansion, multiline prompts, pasted text, and filters out permission prompts (Yes/No) so only meaningful input is pinned
  • AI tool detection — Recognizes Claude Code and Codex by process name; shows the pin bar only during AI sessions
  • PTY passthrough — Zero-interference raw terminal I/O with full ANSI support
  • Update notifications — Background check for new releases, shown in the hint bar

Quick Start

Install globally

npm i -g @steadymoka/murmur
murmur

Run without install

npx @steadymoka/murmur

Build from source

git clone https://github.com/steadymoka/murmur.git
cd murmur
cargo build --release
./target/release/murmur

Murmur launches a shell in the current directory. A hint bar at the bottom shows the prefix key. When you start an AI coding tool, a pin bar appears above it with your prompt history.

Keybindings

All input is forwarded to the PTY. Ctrl+\ is the prefix key.

Key Action
Ctrl+[ Previous pin (older)
Ctrl+] Next pin (newer)
Ctrl+\ x Delete current pin
Ctrl+\ u Show update info
Ctrl+\ q Quit

How It Works

Murmur attaches your terminal to a PTY and reserves a scroll region at the bottom for context bars. A VT100 parser runs in parallel to track process names and screen content.

When a known AI tool is detected, murmur starts recording prompts you enter. Each Enter keystroke pins the prompt to a history bar visible above the hint bar. Slash commands are expanded to their full form via Claude Code's history, and tool permission responses (Yes/No) are filtered out so only your actual prompts are kept.

The prefix key (Ctrl+\) is the only input murmur intercepts — everything else passes through untouched.

License

MIT

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors