---
title: "roqam"
url: "https://claudemods.dev/ko/builds/roqam-08483a"
source: "https://github.com/Telefaxnix/ROQAM/tree/main/roqam"
source_type: "github"
repo: "https://github.com/Telefaxnix/ROQAM/tree/main/roqam"
author: "Telefaxnix"
author_handle: "Telefaxnix"
stars: 0
category: "대시보드 및 HUD"
categories: ["hud"]
tags: ["context-monitor", "hooks", "privacy", "statusline", "weather", "windows"]
permission_level: 3
scan_complete: true
install: "claude plugin marketplace add Telefaxnix/ROQAM\nclaude plugin install roqam@roqam"
added: "2026-10-17T02:27:15.937Z"
updated: "2026-10-16T16:33:01Z"
locale: "ko"
content_locale: "ko"
---

# roqam

Claude Code를 위한 상태 표시줄입니다. 터미널과 데스크톱 앱(Windows 11)의 프롬프트 위에 위치하며, 컨텍스트가 얼마나 찼는지, 플랜 제한을 얼마나 사용했는지, 프롬프트 캐시가 언제 만료되는지, Anthropic의 서비스가 정상인지 한눈에 보여줍니다. 몇 개의 버튼으로 일상적인 단계를 한 번의 클릭으로 처리하고, 맨 아래 줄에는 오늘 밤의 하늘과 현재 위치의 날씨를 표시합니다.

## Description

# ROQAM – Readout & Quick Access Mod

Claude Code를 위한 상태 표시줄입니다. 터미널과 데스크톱 앱(Windows 11)의 프롬프트 위에 위치하며,
컨텍스트가 얼마나 찼는지, 플랜 제한을 얼마나 사용했는지, 프롬프트 캐시가
언제 만료되는지, Anthropic의 서비스가 정상인지 한눈에 보여줍니다. 몇 개의 버튼으로 일상적인 단계를 한 번의 클릭으로 처리하고,
맨 아래 줄에는 오늘 밤의 하늘과 현재 위치의 날씨를 표시합니다.

![Claude Code 프롬프트 위의 ROQAM 상태 표시줄](images/preview-en.png)

Claude가 작업 중일 때 데스크톱 앱(독일어 버전). 녹화 모드가 켜져 있어 개인 값은 회색으로 표시됩니다.

![Claude가 작업 중일 때 Claude 데스크톱 앱의 ROQAM, 독일어 버전, 녹화 모드 켜짐](images/app-de.png)

두 가지 버전이 있습니다. 영어 레이블의 `roqam`과 독일어 레이블의 `roqam-de`입니다. 동일하게 작동하지만,
독일어 버전은 독일어 설정 이름을 사용하고 API 비용을 CHF로 표시합니다([Settings](#settings) 참조). 독일어 가이드는 [ANLEITUNG.md](ANLEITUNG.md)입니다.

ROQAM은 독립 프로젝트입니다. Anthropic이 만들지 않았으며 보증하지 않습니다.

## 요구 사항

- Windows 11
- Claude Code 2.1.289 이상, 터미널 또는 데스크톱 앱

## 설치

세 가지 방법이 있습니다. 하나만 사용하고 한 버전만 설치하세요. 그렇지 않으면 두 개의 표시줄이 실행됩니다.

### 더블 클릭

이 페이지에서 **Code** → **Download ZIP**을 클릭하고 파일을 압축 해제한 후 `Install.bat`을 더블 클릭합니다. 설치 프로그램이
레이블 언어(Windows 언어를 제안함)와 위치(하늘과 날씨에 사용할 도시)를 묻습니다.
mod를 `C:\Users\YOURNAME\.claude\mods\`에 복사하고 `settings.json`에 추가합니다. 그 전에
`settings.json` 사본, mod의 이전 사본, 다른 언어 버전을
`C:\Users\YOURNAME\.claude\backups\`에 넣습니다. 아무것도 삭제되지 않습니다. 그런 다음 Claude Code를 완전히 종료하고 다시 시작합니다.
Windows SmartScreen이 경고하면 "추가 정보"를 선택한 다음 "실행"을 선택합니다.

### 플러그인 관리자

터미널에서:

```
claude plugin marketplace add Telefaxnix/ROQAM
claude plugin install roqam@roqam --config location=London
```

London 대신 자신의 도시를 사용하거나, 하늘과 날씨를 원하지 않으면 `--config location=London`을 생략하세요.
독일어 라벨을 원한다면 대신 `roqam-de@roqam --config ort=Bern`을 설치하세요. 독일어 버전에서는 이 설정을
`ort`라고 부릅니다. 그런 다음 Claude Code를 완전히 종료하고 다시 시작하세요. 데스크톱 앱은 동일한 `settings.json`을 읽으므로 거기에도 바가 표시됩니다.

`claude plugin marketplace update roqam`으로 업데이트한 다음 `claude plugin update roqam@roqam`을 실행하세요. 제거하려면
`claude plugin uninstall roqam@roqam`을 사용하세요.

### 수동으로

1. 위에서 설명한 대로 ZIP을 다운로드하고 압축을 풉니다.
2. `roqam` 폴더를 `C:\Users\YOURNAME\.claude\mods\roqam`에 복사합니다(필요하면 `mods` 폴더를 만드세요).
3. `C:\Users\YOURNAME\.claude\settings.json`을 열고(필요하면 만드세요) 다음 두 블록을 추가합니다. `YOURNAME`과
   `London`을 바꾸세요. 하늘과 날씨를 원하지 않으면 `location`을 비워 두세요.

   ```json
   {
     "env": {
       "CLAUDE_CODE_PLUGIN_DIRS": "C:\\Users\\YOURNAME\\.claude\\mods\\roqam"
     },
     "pluginConfigs": {
       "roqam": {
         "options": {
           "location": "London",
           "apiCost": true,
           "higgsfield": true,
           "promotions": true
         }
       }
     }
   }
   ```

   파일에 이미 내용이 있다면 블록을 병합하고 쉼표에 주의하세요. `CLAUDE_CODE_PLUGIN_DIRS`에
   이미 다른 폴더가 나열되어 있다면 새 경로를 끝에 `;`로 구분하여 추가하세요.
4. Claude Code를 완전히 종료하고 다시 시작하세요.

### 제거

플러그인 관리자를 사용한다면 위를 참조하세요. 그렇지 않으면 `settings.json`의 `CLAUDE_CODE_PLUGIN_DIRS`에서 이 mod의 경로를 제거하고 Claude Code를 다시 시작하세요.

## 바에 표시되는 것

| 항목 | 의미 |
|---|---|
| Top band | Claude가 작업하는 동안: 요청에 대한 짧은 요약과 Claude가 작업 목록을 유지하면 그 진행 상황(`▰▰▰▱▱ 3/5`). `/goal …`을 사용하면 대신 목표를 표시합니다. Claude가 완료되면: 마지막 메시지 이후의 입력 및 출력 토큰과 그 작업이 API 가격으로 얼마였을지(`IN 182.4k · OUT 3.1k · TOTAL 185.5k · API 0.42 USD`). |
| ⏱ Working for … | Claude가 작업하는 동안: 얼마나 실행되었는지, 마지막 단계, 지금까지의 토큰. 단계가 4분 이상 걸리거나 Claude가 같은 호출을 세 번 반복하면 계속할지 묻습니다. |
| Ctx | 채팅의 컨텍스트가 얼마나 찼는지. 75%와 다시 90%에서 `/compact`를 제안하는 힌트가 표시됩니다. |
| 5h / 7D | 요금제의 5시간 및 7일 한도를 얼마나 사용했는지, 각각 언제 재설정되는지. |
| Higgsfield 104.0/270Cr | 귀하의 Higgsfield 크레딧. claude.ai 커넥터 "Higgsfield"를 연결하면 자동으로 나타나며, 나중에 연결해도 표시됩니다. |
| T− | 프롬프트 캐시가 만료되기까지의 분. Claude의 마지막 요청부터 60분 수명으로 계산(`T−55min`; 회색 `T−0`은 만료됨). 그 이후에는 다음 메시지가 전체 채팅을 다시 읽어야 하며, 한도를 더 많이 소모합니다. |
| Claude ● | Anthropic 상태: 초록은 사용 중인 서비스가 정상, 노랑은 저하, 빨강은 중단, 회색은 상태 페이지에 연결할 수 없음. 자세히 보려면 "Claude"를 클릭; 각 인시던트(↗)는 status.claude.com의 페이지를 엽니다. |
| Opus 5.5 · Medium | 이 채팅의 모델과 노력 수준. |
| Session – In / Out | 이 채팅이 지금까지 읽고 쓴 토큰. |
| v2.1.292 / Update | 귀하의 Claude Code 버전. 노란색 "Update"는 새 버전이 나왔다는 의미이며, 클릭하면 어떤 버전인지 볼 수 있습니다. |
| 2 Chats | 이 PC에서 실행 중인 Claude 세션. 클릭하면 목록을 볼 수 있고, 앱 채팅(↗)은 클릭하면 열립니다. |
| Connectors | 이 채팅의 MCP 서버, claude.ai 커넥터 및 로컬 커넥터; 하나가 끊기면 노란색이 됩니다. |
| ⚑ New promotion | Anthropic이 프로모션(클라우드 크레딧, 게스트 패스, 할인, 사용 한도 알림 등)을 변경할 때만 표시됩니다. 클릭하면 변경된 내용을 볼 수 있습니다. |
| API: | 이 채팅, 이 프로젝트, 현재 요금제 월이 API 정가로 얼마였을지. |
| ✓ Save | 요청을 프롬프트 상자에 넣습니다: Claude는 채팅을 검토하고, 빠진 것을 묻지 않고 프로젝트 노트와 메모리에 추가하며, 변경된 프로젝트 파일을 커밋하고 프로젝트에 온라인 사본이 있으면 푸시합니다. 전송은 직접 합니다. |
| ⇢ Handoff | `/handoff` 스킬이 있으면 실행합니다. 없으면 짧은 핸드오프 요청을 프롬프트 상자에 넣습니다. |
| ⇲ Compact | 확인 후 채팅을 압축합니다(`/compact`). |
| + New | 같은 폴더에서 새 채팅을 엽니다(데스크톱 앱: 새 채팅; 터미널: 새 창). |
| ⚡ … t/s | 마지막 답변이 스트리밍된 속도(초당 토큰). |
| ◉ Rec | 녹화 모드: 열려 있는 모든 채팅에서 경로, 비용, 계정, 7일 비율, 요청 요약 및 단계 텍스트를 숨겨 화면 녹화에 사용합니다. 흰색은 꺼짐, 빨강은 켜짐. OBS, Streamlabs, Bandicam 또는 Camtasia가 실행 중이면 자동으로 켜집니다. |
| Seeing: ● | 현재 위치의 오늘 밤 하늘을 초록에서 빨강까지 11단계로. 초록: 맑고 안정적, 밖을 볼 가치가 있음. 빨강에 가까울수록: 구름, 불안정한 공기, 밝은 달 또는 습한 공기. 회색: 데이터 없음. |
| ☁ / moon / ★ | 어두워진 후의 운량, 달 위상, 천문 박명의 시작과 끝. |
| 🌡 / Dew / 💧 | 기온, 이슬점, 습도. 10분마다 업데이트. |

채팅 자체에서 ROQAM은 각 답변의 끝을 회색 "CLAUDE READY" 밴드로 표시합니다. Claude가 작업 도중에
무언가를 물어볼 때, 질문 위의 금색 밴드는 당신의 답변이 현재
작업을 계속한다는 것을 나타냅니다.

Claude ●, 버전, Chats, Connectors, ⚑, API: 또는 ⚡를 클릭하면 세부 정보를 볼 수 있습니다. 다시 클릭하거나 30초 기다리면
카드가 닫힙니다.

`/stars`는 하늘과 날씨를 숨기고 날씨 요청을 중지합니다. 다시 실행하면 되돌아옵니다. 이 설정은
모든 채팅에 적용되며 재시작 후에도 유지됩니다. 프로모션 알림을 클릭할 수 없는 곳에서는 `/promo-seen`이それを 닫습니다
(독일어 버전: `/aktion-gesehen`).

### 자신의 파일에서 온 선택적 항목

Claude Code는 클라우드 크레딧이나 무료 재설정을 mod에 알려주지 않습니다. 그래도 보고 싶다면,
`~\.claude\statusleiste-guthaben.json` 파일에 다음과 같은 항목 목록을 유지하세요
`[{"name": "Cloud credits", "kurz": "Cloud $", "rest": 40, "total": 50, "einheit": "USD", "ablauf": "2026-12-31"}]`.
막대는 각 항목을 남은 일수와 함께 표시하며, 7일 미만이 남으면 ⚠를 표시합니다. `"verbraucht": true`는 하나를 숨깁니다.
"⚠ GitHub" 경고는 당신이 직접 만든 동기화 스크립트가 `~\.claude\github-abgleich.json`을 쓸 때만 나타납니다. 이러한
파일이 없으면 아무것도 나타나지 않습니다.

## 설정

설정은 `settings.json`의 `pluginConfigs` → `roqam` → `options`에 있습니다. 플러그인 관리자를 사용했다면,
`pluginConfigs` → `roqam@roqam` → `options`에 있으며, `claude plugin configure roqam@roqam`으로 표시됩니다.
변경 후 Claude Code를 재시작하세요.

| 설정 | 독일어 버전 | 기본값 | 하는 일 |
|---|---|---|---|
| `location` | `ort` | 비어 있음 | 하늘과 날씨를 위한 도시, 예: `"London"`. 비어 있음: 하늘과 날씨 없음. |
| `apiCost` | `apiKosten` | `true` | 이 채팅, 이 프로젝트 및 플랜 월이 API를 통해 얼마가 들었을지 USD로 표시합니다(독일어 버전: CHF). |
| `higgsfield` | `higgsfield` | `true` | claude.ai 커넥터 "Higgsfield"가 연결되어 있을 때마다 당신의 Higgsfield 크레딧을 표시합니다. `false`는それを 숨깁니다. |
| `higgsfieldMax` | `higgsfieldMax` | `270` | 당신의 Higgsfield 플랜에서 월별 크레딧. |
| `promotions` | `aktionen` | `true` | Anthropic이 프로모션을 변경할 때 "⚑ New promotion"을 표시합니다. |
| `weatherUrl` | `wetterUrl` | 비어 있음 | 자신의 기상 관측소 API 주소. `location`과 함께만 작동합니다. 비어 있음: 온도, 이슬점 및 습도는 Open-Meteo에서 가져옵니다. |
| `newChatFolder` | `neuOrdner` | 비어 있음 | "+ New"가 새 채팅을 여는 폴더. 비어 있음: 현재 채팅의 폴더. |

## 개인정보 보호

바가 저장하는 모든 것은 사용자의 PC에 남아 있습니다. 계정이 필요 없는 공개 서비스에만 연결합니다:

| 서비스 | 용도 |
|---|---|
| Open-Meteo(`api.open-meteo.com`, `geocoding-api.open-meteo.com`) | 날씨, 구름량, 사용자의 마을 찾기 |
| 7Timer(`www.7timer.info`) | 시잉 예보 |
| status.claude.com | 장애 |
| npm 레지스트리(`registry.npmjs.org`) | 최신 Claude Code 버전 |
| 사용자 자신의 기상 관측소(`weatherUrl`) | 설정한 경우에만 |
| Frankfurter(`api.frankfurter.app`) | 미국 달러에서 스위스 프랑 환율(독일어 버전 전용, API 비용이 켜져 있을 때) |

사용자의 PC에서 Claude Code 자체 파일을 읽습니다: `~\.claude.json`(프로모션 및 요금제 시작 날짜),
`~\.claude\sessions`(실행 중인 채팅), 그리고 현재 채팅의 트랜스크립트(`T−`용). API 비용을 위해
다른 트랜스크립트도 읽고 `~\.claude\`에 백업 사본이 있는 비용 로그를 유지합니다. `tasklist`,
PowerShell, `rundll32`, `wt.exe`를 실행합니다. 상단 밴드의 요약을 위해 사용자 자신의 Claude
Code 세션을 통해 Claude Haiku에 요청하며, 이는 요금제의 일부를 사용합니다. 자세한 내용: [PRIVACY.md](PRIVACY.md).

## 문제 해결

- `claude --debug`로 Claude Code를 시작하세요. `roqam`이 포함된 줄이 무엇이 잘못되었는지 보여줍니다.
- 데스크톱 앱에 Higgsfield 크레딧이 없음: `settings.json`의
  `"permissions": { "allow": [ … ] }`에서 커넥터의 `balance` 도구를 허용하세요.
- 조직에서 Claude Code를 중앙에서 관리하는 경우, `/compact` 직후의 컨텍스트 수치는
  다음 업데이트까지 지연될 수 있습니다.

## 크레딧

날씨 및 구름 데이터는 [Open-Meteo.com](https://open-meteo.com/)에서 제공(CC BY 4.0, 비상업적 사용 무료).
시잉 예보는 [7Timer](https://www.7timer.info/)에서 제공(비상업적 사용 무료).

## 라이선스

Copyright 2026 Dominik Sieber. MIT 라이선스([LICENSE-MIT](LICENSE-MIT)) 또는 Apache
라이선스 2.0([LICENSE-APACHE](LICENSE-APACHE)) 중 선택에 따라 라이선스됩니다.

## Install

```
claude plugin marketplace add Telefaxnix/ROQAM
claude plugin install roqam@roqam
```

## Original README

# ROQAM – Readout & Quick Access Mod

A status bar for Claude Code. It sits above the prompt in the terminal and in the desktop app (Windows 11) and
shows at a glance how full your context is, how much of your plan limits you have used, when the prompt cache
expires and whether Anthropic's services are up. A few buttons handle everyday steps with one click, and the
bottom line shows tonight's sky and the weather where you are.

![ROQAM status bar above the Claude Code prompt](images/preview-en.png)

In the desktop app while Claude is working (German version). Recording mode is on, so private values are greyed out.

![ROQAM in the Claude desktop app while Claude is working, German version, recording mode on](images/app-de.png)

There are two versions: `roqam` with English labels and `roqam-de` with German labels. They work the same way,
but the German version uses German setting names and shows API costs in CHF (see [Settings](#settings)). The German guide is [ANLEITUNG.md](ANLEITUNG.md).

ROQAM is an independent project. Anthropic did not make it and does not endorse it.

## Requirements

- Windows 11
- Claude Code 2.1.289 or newer, in the terminal or the desktop app

## Install

There are three ways. Use only one of them and install only one version, otherwise two bars will run.

### Double-click

On this page, click **Code** → **Download ZIP**, unzip the file and double-click `Install.bat`. The installer asks
for the language of the labels (it suggests the language of Windows) and for your location, the town used for sky
and weather. It copies the mod to `C:\Users\YOURNAME\.claude\mods\` and adds it to `settings.json`. Before that it
puts a copy of your `settings.json`, an older copy of the mod and the other language version into
`C:\Users\YOURNAME\.claude\backups\`; nothing is deleted. Then quit Claude Code completely and start it again. If
Windows SmartScreen warns you, choose "More info" and then "Run anyway".

### Plugin manager

In a terminal:

```
claude plugin marketplace add Telefaxnix/ROQAM
claude plugin install roqam@roqam --config location=London
```

Use your own town instead of London, or leave out `--config location=London` if you don't want sky and weather.
For German labels, install `roqam-de@roqam --config ort=Bern` instead; the German version calls the setting
`ort`. Then quit Claude Code completely and start it again. The desktop app reads
the same `settings.json`, so the bar shows up there too.

Update with `claude plugin marketplace update roqam` and then `claude plugin update roqam@roqam`. Remove it with
`claude plugin uninstall roqam@roqam`.

### By hand

1. Download the ZIP as described above and unzip it.
2. Copy the folder `roqam` to `C:\Users\YOURNAME\.claude\mods\roqam` (create the `mods` folder if needed).
3. Open `C:\Users\YOURNAME\.claude\settings.json` (create it if needed) and add these two blocks. Replace
   `YOURNAME` and `London`; leave `location` empty if you don't want sky and weather.

   ```json
   {
     "env": {
       "CLAUDE_CODE_PLUGIN_DIRS": "C:\\Users\\YOURNAME\\.claude\\mods\\roqam"
     },
     "pluginConfigs": {
       "roqam": {
         "options": {
           "location": "London",
           "apiCost": true,
           "higgsfield": true,
           "promotions": true
         }
       }
     }
   }
   ```

   If the file already has content, merge the blocks into it and mind the commas. If `CLAUDE_CODE_PLUGIN_DIRS`
   already lists other folders, add the new path at the end, separated by `;`.
4. Quit Claude Code completely and start it again.

### Uninstall

With the plugin manager, see above. Otherwise remove the mod's path from `CLAUDE_CODE_PLUGIN_DIRS` in
`settings.json` and restart Claude Code.

## What the bar shows

| Item | Meaning |
|---|---|
| Top band | While Claude works: a short summary of your request and, if Claude keeps a task list, its progress (`▰▰▰▱▱ 3/5`). With `/goal …` it shows your goal instead. When Claude is done: tokens in and out since your last message and what that work would have cost at API prices (`IN 182.4k · OUT 3.1k · TOTAL 185.5k · API 0.42 USD`). |
| ⏱ Working for … | While Claude works: how long it has been running, the last step, and the tokens so far. If a step takes more than 4 minutes, or Claude repeats the same call three times, it asks whether to continue. |
| Ctx | How full the chat's context is. At 75% and again at 90% a hint suggests `/compact`. |
| 5h / 7D | How much of your plan's five-hour and seven-day limits you have used, and when each resets. |
| Higgsfield 104.0/270Cr | Your Higgsfield credits. They appear by themselves once the claude.ai connector "Higgsfield" is connected, even if you connect it later. |
| T− | Minutes until the prompt cache expires, counted from Claude's last request with a lifetime of 60 minutes (`T−55min`; grey `T−0` means expired). After that, your next message has to read the whole chat again, which costs more of your limit. |
| Claude ● | Anthropic status: green means the services you use are up, yellow degraded, red down, grey no connection to the status page. Click "Claude" for details; each incident (↗) opens its page on status.claude.com. |
| Opus 5.5 · Medium | Model and effort level of this chat. |
| Session – In / Out | Tokens this chat has read and written so far. |
| v2.1.292 / Update | Your Claude Code version. A yellow "Update" means a newer version is out; click it to see which. |
| 2 Chats | Claude sessions running on this PC. Click for the list; app chats (↗) open on click. |
| Connectors | The MCP servers of this chat, claude.ai connectors and local ones; turns yellow when one drops. |
| ⚑ New promotion | Shows up only when Anthropic changes a promotion, such as cloud credits, guest passes, discounts or usage-limit notices. Click it to see what changed. |
| API: | What this chat, this project and the current plan month would have cost at API list prices. |
| ✓ Save | Puts a request into the prompt box: Claude goes through the chat, adds what is missing to the project notes and its memory without asking, commits the changed project files and pushes them if the project has an online copy. You send it yourself. |
| ⇢ Handoff | Runs your `/handoff` skill if you have one. Otherwise it puts a request for a short handoff into the prompt box. |
| ⇲ Compact | Compacts the chat (`/compact`) after asking. |
| + New | Opens a new chat in the same folder (desktop app: new chat; terminal: new window). |
| ⚡ … t/s | How fast the last answer streamed, in tokens per second. |
| ◉ Rec | Recording mode: hides paths, costs, accounts, the seven-day percentage, the summary of your request and the step text in all open chats, for screen recordings. White is off, red is on. It turns on by itself while OBS, Streamlabs, Bandicam or Camtasia runs. |
| Seeing: ● | Tonight's sky where you are, in eleven steps from green to red. Green: clear and steady, worth a look outside. Towards red: clouds, unsteady air, bright moon or damp air. Grey: no data. |
| ☁ / moon / ★ | Cloud cover after dark, moon phase, and the start and end of astronomical darkness. |
| 🌡 / Dew / 💧 | Temperature, dew point and humidity, updated every 10 minutes. |

In the chat itself, ROQAM marks the end of each answer with a grey "CLAUDE READY" band. When Claude asks you
something in the middle of a task, a gold band above the question says that your answer continues the current
task.

Click Claude ●, the version, Chats, Connectors, ⚑, API: or ⚡ for details. Click again, or wait 30 seconds, to
close the card.

`/stars` hides sky and weather and stops the weather requests; run it again to bring them back. The setting
applies to all chats and survives restarts. Where the promotion notice can't be clicked, `/promo-seen` dismisses
it (German version: `/aktion-gesehen`).

### Optional entries from your own files

Claude Code doesn't tell mods about cloud credits or free resets. If you want to see them anyway, keep a file
`~\.claude\statusleiste-guthaben.json` with a list of entries such as
`[{"name": "Cloud credits", "kurz": "Cloud $", "rest": 40, "total": 50, "einheit": "USD", "ablauf": "2026-12-31"}]`.
The bar shows each entry with the days left and a ⚠ when fewer than 7 remain; `"verbraucht": true` hides one.
A "⚠ GitHub" warning appears only if a sync script of your own writes `~\.claude\github-abgleich.json`. Without
these files, nothing appears.

## Settings

The settings live in `settings.json` under `pluginConfigs` → `roqam` → `options`. If you used the plugin manager,
they are under `pluginConfigs` → `roqam@roqam` → `options`, and `claude plugin configure roqam@roqam` shows them.
Restart Claude Code after a change.

| Setting | German version | Default | What it does |
|---|---|---|---|
| `location` | `ort` | empty | Town for sky and weather, e.g. `"London"`. Empty: no sky and weather. |
| `apiCost` | `apiKosten` | `true` | Shows what this chat, this project and the plan month would have cost via the API, in USD (German version: CHF). |
| `higgsfield` | `higgsfield` | `true` | Shows your Higgsfield credits whenever the claude.ai connector "Higgsfield" is connected. `false` hides them. |
| `higgsfieldMax` | `higgsfieldMax` | `270` | Credits per month in your Higgsfield plan. |
| `promotions` | `aktionen` | `true` | Shows "⚑ New promotion" when Anthropic changes a promotion. |
| `weatherUrl` | `wetterUrl` | empty | Address of your own weather station's API. Works only together with `location`. Empty: temperature, dew point and humidity come from Open-Meteo. |
| `newChatFolder` | `neuOrdner` | empty | Folder in which "+ New" opens the new chat. Empty: the folder of the current chat. |

## Privacy

Everything the bar stores stays on your PC. It only contacts public services that need no account:

| Service | What for |
|---|---|
| Open-Meteo (`api.open-meteo.com`, `geocoding-api.open-meteo.com`) | Weather, cloud cover, finding your town |
| 7Timer (`www.7timer.info`) | Seeing forecast |
| status.claude.com | Incidents |
| npm registry (`registry.npmjs.org`) | Latest Claude Code version |
| Your own weather station (`weatherUrl`) | Only if you set it |
| Frankfurter (`api.frankfurter.app`) | USD to CHF rate (German version only, with API costs on) |

On your PC it reads Claude Code's own files: `~\.claude.json` (promotions and the start date of your plan),
`~\.claude\sessions` (running chats) and the transcript of the current chat (for `T−`). For the API costs it also
reads your other transcripts and keeps a cost log with a backup copy in `~\.claude\`. It runs `tasklist`,
PowerShell, `rundll32` and `wt.exe`. For the summary in the top band it asks Claude Haiku through your own Claude
Code session, which uses a small part of your plan. Details: [PRIVACY.md](PRIVACY.md).

## Troubleshooting

- Start Claude Code with `claude --debug`; lines with `roqam` show what goes wrong.
- No Higgsfield credits in the desktop app: allow the connector's `balance` tool under
  `"permissions": { "allow": [ … ] }` in `settings.json`.
- If your organisation manages Claude Code centrally, the context figure right after `/compact` may lag until
  the next update.

## Credits

Weather and cloud data from [Open-Meteo.com](https://open-meteo.com/) (CC BY 4.0; free for non-commercial use).
Seeing forecasts from [7Timer](https://www.7timer.info/) (free for non-commercial use).

## License

Copyright 2026 Dominik Sieber. Licensed under either the MIT License ([LICENSE-MIT](LICENSE-MIT)) or the Apache
License 2.0 ([LICENSE-APACHE](LICENSE-APACHE)), at your option.