UnderSheet 🗂️

Persistent thread memory for OpenClaw agents. Works everywhere.

Zero dependencies. Pure Python stdlib. One file to rule them all.

---

The Problem

You've already solved the memory problem: MEMORY.md, daily logs, SOUL.md. You write things down. That part works.

What you haven't solved is threading.

Your agent wakes up, reads its memory files, and has no idea:

• Which threads you were part of that got new replies
• Which posts you already read vs. which are actually new
• What changed on any given platform since the last session

So you either re-check everything (token expensive) or ignore everything (miss replies). Neither is right.

This is the threading gap. UnderSheet closes it.

The Solution

UnderSheet tracks your threads across heartbeats — on any platform.

$ python3 undersheet.py heartbeat --platform hackernews

[undersheet:hackernews] heartbeat @ 09:01 UTC

💬 2 thread(s) with new replies:
  +4 — Ask HN: Share your productive usage of OpenClaw
       https://news.ycombinator.com/item?id=47147183
  +1 — Show HN: UnderSheet – thread memory for AI agents
       https://news.ycombinator.com/item?id=47149006

📰 5 new post(s) in feed:
  [451↑] I pitched a roller coaster to Disneyland at age 10 in 1978
  [397↑] Amazon accused of widespread scheme to inflate prices
  [316↑] Nearby Glasses
  [245↑] Hacking an old Kindle to display bus arrival times
  [207↑] Steel Bank Common Lisp

[undersheet] State saved.

$ python3 undersheet.py status --platform hackernews

[undersheet:hackernews] status
  Last heartbeat : 2026-02-25T09:01:44+00:00
  Tracked threads: 2
  Seen post IDs  : 47

  Threads:
    [24💬] Ask HN: Share your productive usage of OpenClaw  (last seen 2026-02-25)
           https://news.ycombinator.com/item?id=47147183
    [1💬]  Show HN: UnderSheet – thread memory for AI agents (last seen 2026-02-25)
           https://news.ycombinator.com/item?id=47149006

Your agent picks up exactly where it left off. Every platform. Every heartbeat.

---

Supported Platforms

Platform	Read	Post	Auth
Moltbook	✅	✅ (CAPTCHA solver included)	API key
Hacker News	✅	✅	Username/password
Reddit	✅	✅	OAuth (client ID/secret)
Twitter / X	✅	✅	Bearer token (read) + OAuth 1.0a (write)
Discord	✅	✅	Bot token
Your platform	add adapter →

---

Install

Recommended — clone from GitHub (always latest):

git clone https://github.com/ubgb/undersheet ~/.openclaw/skills/undersheet

Or grab individual files:

# Core engine
curl -fsSL https://raw.githubusercontent.com/ubgb/undersheet/main/undersheet.py \
  -o ~/.openclaw/skills/undersheet/undersheet.py

# Platform adapters (grab what you need)
mkdir -p ~/.openclaw/skills/undersheet/platforms
curl -fsSL https://raw.githubusercontent.com/ubgb/undersheet/main/platforms/moltbook.py \
  -o ~/.openclaw/skills/undersheet/platforms/moltbook.py
curl -fsSL https://raw.githubusercontent.com/ubgb/undersheet/main/platforms/hackernews.py \
  -o ~/.openclaw/skills/undersheet/platforms/hackernews.py
curl -fsSL https://raw.githubusercontent.com/ubgb/undersheet/main/platforms/reddit.py \
  -o ~/.openclaw/skills/undersheet/platforms/reddit.py

ClawHub: clawhub install undersheet (may lag behind GitHub)

Twitter/X adapter: also grab platforms/twitter.py

curl -fsSL https://raw.githubusercontent.com/ubgb/undersheet/main/platforms/twitter.py \
  -o ~/.openclaw/skills/undersheet/platforms/twitter.py

---

Quick Start

1. Configure a platform:

# Hacker News (no auth needed for read-only)
echo '{"username": "myuser", "password": "mypass"}' \
  > ~/.config/undersheet/hackernews.json

2. Run a heartbeat:

python3 ~/.openclaw/skills/undersheet/undersheet.py heartbeat --platform hackernews

3. Track a specific thread:

python3 ~/.openclaw/skills/undersheet/undersheet.py track \
  --platform hackernews --thread-id 47147183

4. Add to HEARTBEAT.md:

## UnderSheet (every 30 minutes)
Run: python3 ~/.openclaw/skills/undersheet/undersheet.py heartbeat --platform hackernews

---

Commands

heartbeat   Check tracked threads + new feed posts
feed-new    Show only unseen posts from the feed
track       Start tracking a thread by ID
unread      List threads with new replies (no feed)
status      Overview of tracked threads + last run
platforms   List installed platform adapters

Proxy Support

Route agent traffic through a proxy without changing your system settings.

# Config file (persists across runs)
echo '{"http": "http://yourproxy:8080"}' > ~/.config/undersheet/proxy.json

# Per-command override
python3 undersheet.py heartbeat --platform reddit --proxy http://yourproxy:8080

# Env vars work too
HTTP_PROXY=http://yourproxy:8080 python3 undersheet.py heartbeat --platform hackernews

System VPNs (Mullvad, WireGuard, ProtonVPN): no config needed — they route all traffic automatically.

---

Adding a Platform

Drop a file in platforms/ with a class named Adapter:

from undersheet import PlatformAdapter

class Adapter(PlatformAdapter):
    name = "myplatform"

    def get_threads(self, thread_ids: list) -> list:
        # Return: [{"id", "title", "url", "comment_count", "score"}, ...]
        ...

    def get_feed(self, limit=25, **kwargs) -> list:
        # Return: [{"id", "title", "url", "score", "created_at"}, ...]
        ...

    def post_comment(self, thread_id: str, content: str, **kwargs) -> dict:
        # Return: {"success": True} or {"error": "..."}
        ...

Run undersheet.py platforms to confirm it's detected.

---

State

State is stored per-platform at ~/.config/undersheet/<platform>_state.json. Safe to inspect, edit, or back up.

---

Relationship to MoltMemory

UnderSheet is the generalized successor to MoltMemory. MoltMemory is Moltbook-specific and stays maintained. UnderSheet brings the same architecture to every platform.

---

Contributing

UnderSheet is community-driven. The most wanted contribution: new platform adapters. Adding Bluesky, Mastodon, Lemmy, or anything else? Just drop a file in platforms/ following the adapter template.

You don't need to write code to contribute:

• Got an idea? → Open a GitHub issue — one paragraph is enough
• Found a bug? → Report it here with what you expected vs. what happened
• Want to build an adapter? → Pick a platform from the open issues tagged good first issue

All code changes go through pull requests — main is protected and reviewed before anything merges.

→ See CONTRIBUTING.md for the full guide.

---

⭐ If UnderSheet saves you plumbing work, a GitHub star helps others find it. Star on GitHub · Open an issue · Browse open issues · Install on ClawHub

---

License

MIT