Return By Death

Return by Death

English | [繁體中文](README.zh-TW.md)

A persistent Claude Code AI secretary controlled via Telegram, with cross-restart memory persistence (reincarnation mechanism).

---

Why does this exist?

`claude --channels plugin:telegram` runs Claude Code as a Telegram bot — but the entire conversation is a single, ever-growing session. Leave it running long enough and you hit a wall: the context is bloated, auto-compaction quietly drops things you needed, and the AI starts losing track of earlier instructions.

The obvious fix is to restart and start fresh. But restarting means complete amnesia. Every task in flight, every preference you've taught it, every pending follow-up — gone. So you're stuck: let the session rot, or wipe it clean and start over.

There's a second problem layered on top. Even if you're willing to restart, you might not be at your computer. The session is just sitting there on your server, bloated and degrading, and there's nothing you can do about it from your phone.

**This project solves both with one mechanism: reincarnation.**

Instead of a blind restart, the AI summarizes itself before it goes down — key decisions, open tasks, things you care about — writes it to a memory file, then restarts. The new session wakes up, reads the summary, and picks up where things left off. Clean context, no amnesia.

And since you're already talking to it over Telegram, you can trigger this from anywhere. Say "go reincarnate," and it handles everything: summary, restart, online greeting. No SSH, no terminal.

As a side effect, long-running tasks also become less opaque. The AI is required to send a progress update before it starts working, then keep editing it as each step completes — so you're never left staring at a silent chat wondering if anything is happening.

---

Features

• Remote control via Telegram: issue commands from your phone, the AI executes on your server
• Reincarnation memory: conversation summary persists across r