Always-on personal digital footprint recorder with hierarchical memory and LLM-powered retrieval
$git clone https://github.com/hkuds/catchmeInstalls into the current project.
Install catchme by running `git clone https://github.com/hkuds/catchme`, then use it for the current task and follow its documentation at https://github.com/hkuds/catchme.
| 1 | <p align="right"> |
| 2 | <a href="assets/readme/README_zh.md">中文</a> · <a href="assets/readme/README_ja.md">日本語</a> · <a href="assets/readme/README_es.md">Español</a> · <b>English</b> |
| 3 | </p> |
| 4 | |
| 5 | <p align="center"> |
| 6 | <img src="assets/catchme-logo.png" width="360" alt="CatchMe Logo"/> |
| 7 | </p> |
| 8 | |
| 9 | <h1 align="center">CatchMe: Make Your AI Agents Truly Personal</h1> |
| 10 | |
| 11 | <p align="center"> |
| 12 | <b>Capture Your Entire Digital Footprint: Lightweight & Vectorless & Powerful.</b> |
| 13 | </p> |
| 14 | |
| 15 | <p align="center"> |
| 16 | <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue?style=flat" alt="License"></a> |
| 17 | <img src="https://img.shields.io/badge/Python-%E2%89%A53.11-3776AB?style=flat&logo=python&logoColor=white" alt="Python"> |
| 18 | <img src="https://img.shields.io/badge/Platform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey?style=flat" alt="Platform"> |
| 19 | <a href="https://hkuds.github.io/CatchMe"><img src="https://img.shields.io/badge/Blog-online-orange?style=flat" alt="Blog"></a> |
| 20 | <img src="https://img.shields.io/badge/Report-coming%20soon-lightgrey?style=flat" alt="Report"> |
| 21 | <br> |
| 22 | <a href="./COMMUNICATION.md"><img src="https://img.shields.io/badge/Feishu-Group-E9DBFC?style=flat-square&logo=feishu&logoColor=white" alt="Feishu"></a> |
| 23 | <a href="./COMMUNICATION.md"><img src="https://img.shields.io/badge/WeChat-Group-C5EAB4?style=flat-square&logo=wechat&logoColor=white" alt="WeChat"></a> |
| 24 | <a href="https://discord.gg/2vDYc2w5"><img src="https://img.shields.io/badge/Discord-Join-7289DA?style=flat-square&logo=discord&logoColor=white" alt="Discord"></a> |
| 25 | </p> |
| 26 | |
| 27 | <p align="center"> |
| 28 | <a href="#-key-features">Features</a> · |
| 29 | <a href="#%EF%B8%8F-how-it-works">How It Works</a> · |
| 30 | <a href="#-llm-configuration">LLM Config</a> · |
| 31 | <a href="#-get-started">Get Started</a> · |
| 32 | <a href="#-cost--efficiency">Cost</a> · |
| 33 | <a href="#-community">Community</a> |
| 34 | </p> |
| 35 | |
| 36 | <p align="center"><i>「 <b>Just do your thing. CatchMe captures everything else — stored locally to ensure privacy and security. </b> 」</i></p> |
| 37 | |
| 38 | <p align="center"> |
| 39 | <img src="assets/terminal_demo.svg" alt="CatchMe Terminal Demo"/> |
| 40 | </p> |
| 41 | |
| 42 | **🦞 Makes Your Agents Truly Personal**. CatchMe ships as an agent-compatible skill for CLI agents (OpenClaw, NanoBot, Claude, Cursor, etc.). Run CatchMe independently. Your agents query memories via CLI commands only. |
| 43 | ## |
| 44 | |
| 45 | |
| 46 | ## 🎯 Enrich Your Personal Digital Context |
| 47 | |
| 48 | <table width="100%"> |
| 49 | <tr> |
| 50 | <td align="center" width="25%" valign="top"> |
| 51 | <img src="assets/usecase_coding.png" height="150" alt="Coding"/><br> |
| 52 | <h3>💻 Personal Coding Assistant</h3> |
| 53 | <b><i>"What was I coding in Claude Code today?"</i></b><br><br> |
| 54 | <div align="left"> |
| 55 | • Code session replay<br> |
| 56 | • Recall your edited files<br> |
| 57 | • Trace what you typed |
| 58 | </div> |
| 59 | </td> |
| 60 | <td align="center" width="25%" valign="top"> |
| 61 | <img src="assets/usecase_research.png" height="150" alt="Research"/><br> |
| 62 | <h3>🔍 Personal Deep Research</h3> |
| 63 | <b><i>"What was I reading about AI yesterday?"</i></b><br><br> |
| 64 | <div align="left"> |
| 65 | • Web/PDF viewed<br> |
| 66 | • Search queries typed<br> |
| 67 | • Reading info tracked |
| 68 | </div> |
| 69 | </td> |
| 70 | <td align="center" width="25%" valign="top"> |
| 71 | <img src="assets/usecase_files.png" height="150" alt="Files"/><br> |
| 72 | <h3>📁 Personal Files Manager</h3> |
| 73 | <b><i>"Which files did I change today?"</i></b><br><br> |
| 74 | <div align="left"> |
| 75 | • File changes tracked<br> |
| 76 | • Docs accessed<br> |
| 77 | • Edits reviewed |
| 78 | </div> |
| 79 | </td> |
| 80 | <td align="center" width="25%" valign="top"> |
| 81 | <img src="assets/usecase_digital_life.png" height="150" alt="Digital Life"/><br> |
| 82 | <h3>🧩 Digital Life Overview</h3> |
| 83 | <b><i>"How did I spend my afternoon?"</i></b><br><br> |
| 84 | <div align="left"> |
| 85 | • App usage tracked<br> |
| 86 | • Workflows replayed<br> |
| 87 | • Activities recalled |
| 88 | </div> |
| 89 | </td> |
| 90 | </tr> |
| 91 | </table> |
| 92 | |
| 93 | ## ✨ Key Features |
| 94 | |
| 95 | ### 📹 |