https://github.com/tikket1/tikket-statusline
A feature-rich statusline for Claude Code
https://github.com/tikket1/tikket-statusline
claude claude-code cli developer-tools statusline terminal
Last synced: 3 months ago
JSON representation
A feature-rich statusline for Claude Code
- Host: GitHub
- URL: https://github.com/tikket1/tikket-statusline
- Owner: tikket1
- License: mit
- Created: 2026-02-10T11:52:11.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-02-12T13:52:44.000Z (4 months ago)
- Last Synced: 2026-02-12T22:30:00.848Z (4 months ago)
- Topics: claude, claude-code, cli, developer-tools, statusline, terminal
- Language: JavaScript
- Size: 7.81 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# tikket-statusline
A feature-rich statusline for [Claude Code](https://docs.anthropic.com/en/docs/claude-code).
 
## What you get
```
◆ Opus 4.6 · ⌥ main*↑2 · ⚑ 3 · ⌂ myproject · v1.2.0 · ⏱ 3h ago · ▸ Fixing bug [2/5] · ⊙ 2 agents · ━━━━━━───────── 40%
```
| Indicator | Description |
|---|---|
| `◆ Opus 4.6` | Active model |
| `⌥ main*↑2↓1` | Git branch, dirty state (`*`), commits ahead (`↑`) / behind (`↓`) remote |
| `⚑ 3` | Git stash count (hidden if none) |
| `⌂ myproject ⊕wt` | Working directory + worktree indicator if in a non-main worktree |
| `v1.2.0` | Version from `package.json` (hidden if none) |
| `⏱ 3h ago` | Time since last commit |
| `▸ Fixing bug [2/5]` | Active task + progress from Claude's task list |
| `⊙ 2 agents` | Running subagents (hidden if none) |
| `━━━───────── 25%` | Context window usage with color gradient (green → yellow → orange → red → 💀) |
Everything hides gracefully when not applicable — no stashes, no stash indicator. No agents running, no agent count. Clean and minimal by default.
**Narrow terminal?** The statusline automatically adapts to your terminal width. Lower-priority segments are progressively dropped while the context window bar is always preserved on the right.
## Install
**One-liner:**
```bash
curl -fsSL https://raw.githubusercontent.com/tikket1/tikket-statusline/main/install.sh | bash
```
**Manual:**
1. Download `statusline.js` to `~/.claude/hooks/`:
```bash
mkdir -p ~/.claude/hooks
curl -fsSL https://raw.githubusercontent.com/tikket1/tikket-statusline/main/statusline.js -o ~/.claude/hooks/statusline.js
```
2. Add to `~/.claude/settings.json`:
```json
{
"statusLine": {
"type": "command",
"command": "node \"~/.claude/hooks/statusline.js\""
}
}
```
3. Restart Claude Code.
## Uninstall
```bash
rm ~/.claude/hooks/statusline.js
```
Then remove the `"statusLine"` block from `~/.claude/settings.json`.
## Requirements
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) with statusLine support
- Node.js (ships with Claude Code)
- Git (for branch/stash/worktree indicators)
## License
MIT