https://github.com/polina4096/liment

Convenient macOS app to display LLM usage limits in the tray.
https://github.com/polina4096/liment

anthropic claude lllms llm macos statistics tray tray-app tray-application

Last synced: 4 months ago
JSON representation

Convenient macOS app to display LLM usage limits in the tray.

Host: GitHub
URL: https://github.com/polina4096/liment
Owner: polina4096
License: unlicense
Created: 2026-02-06T20:09:24.000Z (5 months ago)
Default Branch: main
Last Pushed: 2026-03-05T22:20:07.000Z (4 months ago)
Last Synced: 2026-03-06T01:58:36.311Z (4 months ago)
Topics: anthropic, claude, lllms, llm, macos, statistics, tray, tray-app, tray-application
Language: Rust
Homepage:
Size: 218 KB
Stars: 0
Watchers: 0
Forks: 1
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

README

# liment

Simple tray application that shows LLM usage limits.

## Configuration

The config file is located at `~/.config/liment/config.toml` and is created automatically on first launch.

### Claude Code

Uses the Claude Code OAuth token from the system keychain. No extra configuration needed.

```toml
provider = "claude_code"
```

Optionally, you can provide a token manually:

```toml
provider = "claude_code"

[settings.claude_code]
token = "sk-ant-..."
```

### CLIProxy Claude

Proxies requests through a [CLIProxy](https://github.com/nicholasgasior/cliproxy) instance.

```toml
provider = "cliproxy_claude"

[settings.cliproxy_claude]
base_url = "http://localhost:8317"
management_token = "your-management-secret"
auth_index = "0"
```

### General options

```toml
# Whether to render the tray icon in monochrome.
monochrome_icon = true

# Display mode: "usage" or "remaining".
display_mode = "usage"

# Whether to show period percentage next to "resets in".
show_period_percentage = false

# Reset time format: "relative" (resets in 3h) or "absolute" (resets on 13 Feb, 14:00).
reset_time_format = "relative"

# How often to refetch usage data, in seconds.
refetch_interval = 60
```

## License

Distributed under the The Unlicense, except for the Claude logo.