Omarchy Weread — Development skill for Claude Code

WeRead for Omarchy

微信读书 reading stats as a native [Omarchy](https://omarchy.org) shell plugin (Omarchy 4 "Quattro" or later), powered by the official [WeRead agent API](https://github.com/Tencent/WeChatReading).

• Bar widget — an open-book glyph in the bar. A dot on the spine appears once you've read today; the tooltip carries 今天 / 本周 time and your consecutive-days streak.
• Four period views — 本周 / 本月 / 今年 / 总计 (keys 1–4), each with a bar chart at matching granularity: days, days, months, years. Week-over-week trend, friend ranking, and preference words (偏好夜间阅读 …) ride along when the API offers them.
• 正在读 — progress bars for the three most recently read books on your shelf.
• 读得最多 — the books the period's time actually went to.
• 热门划线 — a popular highlight from your top book, re-rolled every time the panel opens, with its 划线人数.
• Lifetime footprint — 读过 / 读完 / 阅读天数 / 笔记 counts, shelf size, and a 为你推荐 pick in the footer.
• Disk cache — the last good bundle lives in ~/.local/state/omarchy/weread/bundle.json, so the bar never starts blank.

Setup

The plugin talks to the WeRead API gateway (`i.weread.qq.com/api/agent/gateway`) and needs an API key bound to your account:

1. Get your key at weread.qq.com/r/weread-skills (format wrk-…)
2. Provide it either way — the key file is the reliable one, because the shell is a long-running graphical process that never sources your .bashrc:

# a) key file (recommended)
mkdir -p ~/.config/omarchy/weread
echo -n wrk-xxxxxxxx > ~/.config/omarchy/weread/api-key
chmod 600 ~/.config/omarchy/weread/api-key

# b) environment variable (only if the shell process itself sees it)
export WEREAD_API_KEY=wrk-xxxxxxxx

Install

omarchy plugin add https://github.com/ya-luotao/omarchy-weread.git