Workspace identity for coding agents

One quiet line.
Zero workspace doubt.

Keep Claude Code's actual project, directory, branch, and machine visible—without turning your terminal into a dashboard.

Install in 30 seconds View source

Open source · MIT · No telemetry · No network calls in the render path

01 / localClaude Code

agent-terminal-status·main·snowy-atlas

02 / worktreeClaude Code

payments-api/docs·feature/handoff·snowy-atlas

03 / sshClaude Code

api/infra/migrations·release·build-eu

cwd is the invariantbranch + host adapt

3 OSescross-platform CI

150 msper Git probe deadline

1 linewidth invariant

0runtime dependencies on Windows

The expensive mistake is invisible

Parallel agents make location a safety signal.

When several terminals look alike, the wrong repository can feel exactly like the right one—until a command lands.

Actual directoryrepo / nested cwdalways

The place where the next filesystem or Git action will actually land.

Git branchmainadaptive

Useful worktree context, but the first field to leave when width is scarce.

Machinesnowy-atlasadaptive

A local, SSH, WSL, or container identity—with an alias when privacy matters.

Install once. Remove cleanly.

A safe 30-second setup.

WindowsPowerShell 5.1+

No extra runtime.

Uses the PowerShell already present on Windows. Git is optional; quoted forward-slash paths survive Claude Code's Git Bash routing.

git clone https://github.com/snowyukitty/agent-terminal-status.git; cd agent-terminal-status; powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\install.ps1

macOS / LinuxPython 3.9+

Small and portable.

The Python adapter uses only the standard library. It follows the same rendering and rollback contract as Windows.

git clone https://github.com/snowyukitty/agent-terminal-status.git && cd agent-terminal-status && sh scripts/install.sh

Your existing status line is treated as user data.

Installation refuses ambiguous replacement. With explicit force, it saves the exact previous value; uninstall restores it only while the active command is still ours.

Uninstall guide ↗

Calm under real conditions

Useful identity, graceful fallback.

renderer / fixtures96 cols

Repository rootagent-terminal-status · main · snowy-atlas

Nested directoryagent-terminal-status/docs/research · feature/identity · snowy-atlas

Detached HEADagent-terminal-status · detached@3f21a7c · snowy-atlas

Outside Git~/scratch/notes · snowy-atlas

Narrow terminalagent-term…cs/research · snowy-atlas

The path always wins. If Git is absent, slow, or detached, the renderer still returns a useful location instead of a blank row.

01
Read Claude context
Prefer workspace.current_dir, then safe fallbacks.
02
Collect bounded Git identity
git -C, no optional locks, 150 ms deadline.
03
Render for available width
CJK-aware middle shortening; optional fields leave first.

Tested against the awkward parts

Built for messy terminals.

01Windows PowerShell 5.1

02PowerShell 7

03Python 3.9+

04Git Bash routing

05Linked worktrees

06Detached HEAD

07Non-Git directories

08CJK & spaced paths

Prototype locally. Advocate narrowly.

The best endpoint is native identity.

This project proves the UX through Claude Code's existing command status line. The upstream proposal stays intentionally smaller: make the actual current directory persistently visible, repository-relative when possible, and adaptive when narrow.

Read the evidence packet ↗Explore the roadmap ↗

Now / validated

Workspace identity

cwd · repository · worktree · branch · machine

Next / evidence first

Development state

dirty · conflict · ahead/behind · remote context

Explore / opt-in

Agent coordination

task · ownership · overlap · handoff

Know where the next command lands.

Give every agent a visible workspace.

Install agent-terminal-status How it works · EN / ES / 日本語 / 繁體中文 Star on GitHub

One quiet line.Zero workspace doubt.