tToqi Tahamid Sarker
  • About
  • Publications
  • Projects
  • Resume
  • Blog
AboutPapersProjectsResumeBlog
© 2026 Toqi Tahamid Sarker • All rights reserved
EntriesLinksNotesQuotesTILsGuides

Customize Your Claude Code Status Line

Claude Code has a status bar at the bottom of the terminal. By default it's minimal — but you can make it show anything you want.

Claude Code status line showing git branch, context remaining, model, time, MCP servers, and plugins

The easiest way: just ask Claude to build it for you.

Open Claude Code and say something like:

"Add a custom status line that shows my username, current directory, git branch, context remaining, and current model"

Claude will write the script and wire up the config automatically.


How it works

Claude Code runs a shell script every time the status bar updates, passing session data as JSON. Your script reads that data and prints whatever you want.

Claude will add this to ~/.claude/settings.json:

"statusLine": {
  "type": "command",
  "command": "bash ~/.claude/statusline-command.sh"
}

And write the script at ~/.claude/statusline-command.sh.


What you can show

Things available from Claude Code directly:

  • Context remaining — how much of the context window is left
  • Current model — e.g. Sonnet 4.6, Opus 4.5
  • Current directory and project path

Things your script can pull from the system:

  • Git branch and whether you have uncommitted changes
  • Active MCP servers and enabled plugins
  • Current time
  • Todo count from your active task list

Tweaking it

Once it's set up, keep refining it conversationally:

"Make the context percentage turn red when it's below 20%"

"Add the active MCP server names at the end"

"Show the time in 12-hour format"

Claude reads the existing script, makes the change, and tests it. No need to touch the file yourself.

Posted 1st March 2026

Recent articles

  • ▪claude-mem: The AI That Takes Notes While You Code — 15th April 2026
  • ▪Modern Transformer Architecture: A Curated YouTube Course — 10th April 2026
  • ▪The Idea File: Why LLM Agents Change How We Share Work — 4th April 2026
  • ▪Using LLMs to Build Personal Research Knowledge Bases — 2nd April 2026
  • ▪Flow Matching and Diffusion Models from Scratch: Free Lecture Notes — 20th March 2026

This is Customize Your Claude Code Status Line by Toqi Tahamid Sarker, posted on 1st March 2026.

claude-code3tools4productivity7ai6

Table of Contents

Next: LLM Architecture Gallery: Every Major Architecture in One Place

Previous: The Shorthand Guide to Everything Claude Code