https://github.com/ramonclaudio/claude-code-statusline
Beautiful status line for Claude Code. Shows git status, model context, and project info at a glance.
https://github.com/ramonclaudio/claude-code-statusline
anthropic anthropic-claude claude claude-code claude-code-status-line claude-code-statusline status-line statusline
Last synced: 16 days ago
JSON representation
Beautiful status line for Claude Code. Shows git status, model context, and project info at a glance.
- Host: GitHub
- URL: https://github.com/ramonclaudio/claude-code-statusline
- Owner: ramonclaudio
- License: mit
- Created: 2025-09-10T13:14:29.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-12-15T06:22:06.000Z (2 months ago)
- Last Synced: 2025-12-21T21:39:18.804Z (about 2 months ago)
- Topics: anthropic, anthropic-claude, claude, claude-code, claude-code-status-line, claude-code-statusline, status-line, statusline
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/create-claude-statusline
- Size: 1.62 MB
- Stars: 2
- Watchers: 0
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Citation: CITATION.cff
- Codeowners: CODEOWNERS
- Security: SECURITY.md
- Support: SUPPORT.md
Awesome Lists containing this project
README
# create-claude-statusline
Beautiful, highly customizable status line for Claude Code with granular control over every element.
## Quick Start
```bash
npm create claude-statusline
```
*Adds a beautiful status line to your Claude Code. ZERO dependencies in your project.*
## What You Get
```
[ ◈ my-project on ⎇ main via ◉ React (node) | ↑ 2 / + 1 / ~ 3 / ? 2 | ⌘ Sonnet 4.5 ]
```
- Project name, git branch, framework, and runtime
- Commit status (ahead/behind)
- Git status indicators (staged, modified, untracked)
- Current Claude model
- Fully customizable: toggle any element, change colors, swap icons
## Installation
```bash
npm create claude-statusline
```
Or with other package managers:
```bash
npx create-claude-statusline # npx
pnpm dlx create-claude-statusline # pnpm
bunx create-claude-statusline # bun
```
Global install:
```bash
npm install -g create-claude-statusline
create-claude-statusline # or use alias: ccs
```
## Customization
Edit `.claude/scripts/statusline-config.cjs` to customize:
### Feature Toggles
```javascript
FEATURES: {
SHOW_PROJECT: true, // Show project name
SHOW_GIT_BRANCH: true, // Show git branch
SHOW_FRAMEWORK: true, // Show detected framework (React, Vue, etc.)
SHOW_RUNTIME: true, // Show runtime (Node.js, Bun, etc.)
SHOW_GIT_AHEAD: true, // Show commits ahead of remote
SHOW_GIT_BEHIND: true, // Show commits behind remote
SHOW_GIT_STAGED: true, // Show staged files
SHOW_GIT_MODIFIED: true, // Show modified (unstaged) files
SHOW_GIT_UNTRACKED: true, // Show untracked files
SHOW_MODEL: true, // Show Claude model name
}
```
### Colors
Color scheme follows an intuitive severity gradient:
```javascript
COLORS: {
PROJECT: '\x1b[38;5;110m', // Muted steel blue
BRANCH: '\x1b[38;5;109m', // Slate gray-blue
FRAMEWORK: '\x1b[38;5;145m', // Cool gray
RUNTIME: '\x1b[38;5;180m', // Muted beige
GIT_AHEAD: '\x1b[38;5;109m', // Slate blue
GIT_BEHIND: '\x1b[38;5;167m', // Soft coral
GIT_STAGED: '\x1b[38;5;108m', // Muted teal-green
GIT_MODIFIED: '\x1b[38;5;180m', // Muted amber
GIT_UNTRACKED: '\x1b[38;5;167m', // Soft coral
MODEL: '\x1b[38;5;146m', // Soft gray-green
}
```
### Icons
```javascript
ICONS: {
PROJECT: '◈',
BRANCH: '⎇',
GIT_AHEAD: '↑',
GIT_BEHIND: '↓',
GIT_STAGED: '+',
GIT_MODIFIED: '~',
GIT_UNTRACKED: '?',
MODEL: '⌘'
}
```
### Supported Frameworks & Runtimes
**Frameworks:** `Next.js`, `Nuxt.js`, `NestJS`, `React`, `Vue`, `Angular`, `Svelte`, `Express`, `Fastify`
**Runtimes:** `Node.js`, `Bun`, `TypeScript`, `Python`, `Rust`, `Go`, `Java`, `C/C++`
All configuration is centralized in `.claude/scripts/statusline-config.cjs` - one file to control everything!
## Safety
Your existing `.claude` directory is automatically backed up to `.create-claude-statusline-backup-[timestamp]` before installation.
## Uninstall
```bash
rm -rf .claude/scripts/statusline*.cjs
```
Then remove the `"statusLine"` section from `.claude/settings.local.json`.
## License
MIT © [RMNCLDYO](https://github.com/RMNCLDYO)