Shimmer

Reflect your shell prompt into Claude Code's status line.

shimmer /ˈʃɪmər/ — shell + mirror. Your prompt, reflected.

Purpose

Your terminal prompt is your digital signature - the face you've crafted for your command line. Shimmer reflects that identity into Claude Code, keeping your environment consistent and familiar.

Usage

# Parse a PS1 string and generate statusLine config
python scripts/shim.py parse "\u@\h:\w\$"

# Auto-detect from common shell config locations
python scripts/shim.py detect

# Detect from a specific file
python scripts/shim.py detect --file ~/.bashrc

# Preview what the statusLine would look like
python scripts/shim.py preview "\u@\h:\w"

# Apply directly to Claude Code settings
python scripts/shim.py apply --preview
python scripts/shim.py apply --confirm

Supported Shells

Bash PS1

Escape	Meaning	StatusLine
\u	Username	{user}
\h	Hostname (short)	{hostname}
\H	Hostname (full)	{hostname}
\w	Working directory	{cwd}
\W	Basename only	{cwd_basename}
\$	$ or #	$
\t	Time (24h)	{time}
\T	Time (12h)	{time_12}
\d	Date	{date}

Zsh PROMPT

Escape	Meaning	StatusLine
%n	Username	{user}
%m	Hostname (short)	{hostname}
%~	Working directory	{cwd}
%.	Basename only	{cwd_basename}
%#	% or #	$
%T	Time (24h)	{time}
%t	Time (12h)	{time_12}

Fish

Fish prompts are functions. Shimmer detects common patterns:

Pattern	StatusLine
$USER, whoami	{user}
$hostname, hostname	{hostname}
$PWD, pwd, prompt_pwd	{cwd}
basename $PWD	{cwd_basename}
date	{time}

Config locations checked:

• ~/.config/fish/functions/fish_prompt.fish
• ~/.config/fish/config.fish

PowerShell

Pattern	StatusLine
$env:USERNAME	{user}
$env:COMPUTERNAME	{hostname}
Get-Location, $PWD	{cwd}

Examples

# Bash
$ python scripts/shim.py parse "\u@\h:\w\$ "
{user}@{hostname}:{cwd}$

# Zsh
$ python scripts/shim.py parse --zsh "%n@%m:%~%# "
{user}@{hostname}:{cwd}$

# Fish (auto-detected)
$ python scripts/shim.py detect --file ~/.config/fish/functions/fish_prompt.fish
{user}@{hostname}:{cwd}$

# Preview with your actual values
$ python scripts/shim.py preview "\u@\h:\w"
alice@wonderland:~/projects

Integration

After generating your statusLine format, add it to .claude/settings.local.json:

{
  "statusLine": "{user}@{hostname}:{cwd}$ "
}

Or use apply --confirm to do this automatically.

Alias

For convenience, alias shimmer to shim:

alias shim="python /path/to/shimmer/scripts/shim.py"