Skip to content

Releases: SeaAndy/cursor-slime

v0.1.0 — first public release

22 May 12:51
@SeaAndy SeaAndy
v0.1.0
99a0c6c

Choose a tag to compare

View all tags
v0.1.0 — first public release Latest
Latest

A pixel-art slime desktop pet that reacts to your Cursor IDE / agent activity in real time. macOS only.

English · 简体中文

English

What's in this release

  • PyQt6 desktop pet (slime.py) with 4 animated states: idle / thinking / working / sleeping
  • One-command installer (install.sh) — sets up venv, hooks, app bundle, icon
  • Cursor hook script (hooks/log-stats.sh) that logs agent activity into ~/.cursor/pet-stats.jsonl
  • Process manager (slimectl) for terminal start / stop / restart / status / logs
  • macOS .app bundle: no Dock icon, no taskbar presence, always-on-top transparent window
  • Bilingual docs (English / 简体中文)

Install

# Download cursor-slime-v0.1.0.zip from this page, then:
unzip cursor-slime-v0.1.0.zip
cd cursor-slime
./install.sh

Launch via Spotlight (Cmd+Space → Cursor Slime) or open ~/Applications/CursorSlime.app.

Requirements

  • macOS 10.15+ (tested on Sonoma / Sequoia)
  • Python 3.11+ with venv (brew install python@3.13 recommended)
  • jq (brew install jq)
  • Cursor IDE with hook support

Known limitations

  • macOS only. Linux/Windows ports welcome.
  • Token count is estimated as (in_chars + out_chars) / 4 — Cursor's hook payload doesn't carry real usage fields yet.
  • No code signing — Gatekeeper may flag the .app as "unidentified developer" on first open. Right-click → Open to bypass.

See the README for full docs.

简体中文

本次发布包含

  • PyQt6 桌宠主程序 (slime.py),含 4 种状态动画:空闲 / 思考 / 工作 / 睡眠
  • 一键安装脚本 (install.sh) —— 自动配置 venv、hook、应用包、图标
  • Cursor hook 脚本 (hooks/log-stats.sh),把 agent 活动写入 ~/.cursor/pet-stats.jsonl
  • 进程管理工具 (slimectl):终端 start / stop / restart / status / logs
  • macOS .app 应用包:不占程序坞、不占任务栏、总在最前的透明窗口
  • 双语文档(English / 简体中文)

安装

# 从本页面下载 cursor-slime-v0.1.0.zip,然后:
unzip cursor-slime-v0.1.0.zip
cd cursor-slime
./install.sh

通过 Spotlight 启动(Cmd+Space → Cursor Slime)或打开 ~/Applications/CursorSlime.app。

环境要求

  • macOS 10.15+(在 Sonoma / Sequoia 上测过)
  • Python 3.11+,带 venv(推荐 brew install python@3.13)
  • jq(brew install jq)
  • Cursor IDE,需开启 hook 支持

已知限制

  • 仅支持 macOS,Linux / Windows 移植欢迎 PR
  • Token 数是估算值:(输入字符数 + 输出字符数) / 4 —— Cursor hook payload 暂时不暴露真实 usage 字段
  • 应用未签名 —— Gatekeeper 首次打开可能报"未识别的开发者",右键 → 打开 即可

完整文档见 README.zh-CN.md。

Assets 4
Loading