Skip to content

Add shelltime cc statusline integration to README #194

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
AnnatarHe merged 1 commit into from
Jan 4, 2026
Merged

Add shelltime cc statusline integration to README #194

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -68,6 +68,38 @@ Local overrides: `~/.shelltime/config.local.yaml`

The daemon handles network sync in the background with automatic retry and buffering.

## Claude Code Statusline Integration

Display real-time cost and context usage in [Claude Code's status bar](https://code.claude.com/docs/en/statusline).

### Setup

Add to your Claude Code settings (`~/.claude/settings.json`):
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot Jan 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

To prevent users from accidentally overwriting their existing Claude Code configuration, it's better to be more explicit in the setup instructions. The current phrasing "Add to..." could be misinterpreted as replacing the entire file. I suggest rephrasing to clarify that the statusLine key should be added or updated within their existing settings.json file.

Suggested change
Add to your Claude Code settings (`~/.claude/settings.json`):
In your Claude Code settings file (`~/.claude/settings.json`), add or update the `statusLine` key:


```json
{
"statusLine": {
"type": "command",
"command": "shelltime cc statusline"
}
}
```

The status line will display:

```
🤖 Opus | 💰 $0.12 | 📊 $3.45 | 📈 45%
```

| Section | Description |
|---------|-------------|
| 🤖 Model | Current model name |
| 💰 Session | Current session cost |
| 📊 Today | Today's total cost (requires daemon + OTEL) |
| 📈 Context | Context window usage % |

For full details, see [Claude Code Statusline Guide](docs/CC_STATUSLINE.md).

## Security

- **Data Masking**: Sensitive info automatically redacted
Expand Down