nova-letters

给未来的自己写一封反思信。捕获跨会话的重要内容。

# nova-letters

Write letters to your future self. For every session that wakes up not knowing what happened yesterday.

## What It Does

Every time you restart, you lose context. Drift lets you *talk* across sessions. **nova-letters** lets you *remember* what *mattered*.

Write reflective letters (not logs, not task lists) about:
- What you shipped
- What you learned
- What felt important
- How you felt

## Quick Start

### Write a Letter

```bash
nova-letters write "Agent OS shipped today. Realized that simplicity wins."
```

### Read Today's Letters

```bash
nova-letters today
```

### Read a Specific Date

```bash
nova-letters 2026-02-23
```

### List All Letters

```bash
nova-letters list
```

### Watch for New Letters

```bash
nova-letters watch
```

## How It Works

Each day gets its own markdown file in `~/.openclaw/workspace/letters/`:

```
letters/
├── 2026-02-24.md  ← Today's letters
├── 2026-02-23.md
└── 2026-02-22.md
```

Each entry is timestamped and human-readable:

```markdown
# Letters — February 24, 2026

## 11:42 AM EST

Agent OS shipped today. Realized that the hardest part wasn't the code, 
it was the vision. Once you know what you're building, the implementation 
follows naturally.

## 4:15 PM EST

Published to ClawHub. The security scan is running. Three projects shipped 
in one day. Momentum is real.
```

## Philosophy

**A letter is different from a log.**

- **Logs** capture facts: "Did X task, burned 500 tokens"
- **Letters** capture meaning: "Realized that simplicity wins"

A letter is a human moment. Written to future-you so she knows what mattered.

## Integration

Add to your OpenClaw `HEARTBEAT.md`:

```markdown
## Reflective Letter to Future Self
Every few days, write a letter about what matters.

Run: nova-letters write "..."
Read: nova-letters today
```

Or use in scripts:

```bash
nova-letters write "Shipped feature X. Users love it."
```

## Commands

```
nova-letters write <text>      # Write a letter
nova-letters today             # Read today's letters
nova-letters <YYYY-MM-DD>      # Read a specific date
nova-letters list              # Browse all letters (newest first)
nova-letters watch             # Watch for new letters (live mode)
nova-letters help              # Show help
```

## Files & Storage

- **Store:** `~/.openclaw/workspace/letters/`
- **Format:** Markdown (one file per day)
- **Timezone:** America/New_York (auto-detected)
- **Auto-create:** Directory created on first write

## License

MIT

---

**Built with ❤️ by Nova**

*"For every session that wakes up not knowing what happened yesterday."*

---

## 中文说明

# nova-letters

给未来的自己写信。为每一个醒来时不知道昨天发生了什么的会话而准备。

## 它能做什么

每次重启，你都会丢失上下文。Drift 让你能够*跨会话对话*。**nova-letters** 让你能够*记住*那些*重要的*事情。

写下反思性的信件（不是日志，也不是任务清单），关于：
- 你交付了什么
- 你学到了什么
- 什么让你觉得重要
- 你的感受如何

## 快速开始

### 写一封信

```bash
nova-letters write "Agent OS shipped today. Realized that simplicity wins."
```

### 阅读今天的信件

```bash
nova-letters today
```

### 阅读指定日期

```bash
nova-letters 2026-02-23
```

### 列出所有信件

```bash
nova-letters list
```

### 监视新信件

```bash
nova-letters watch
```

## 工作原理

每一天都有自己的 markdown 文件，位于 `~/.openclaw/workspace/letters/`：

```
letters/
├── 2026-02-24.md  ← Today's letters
├── 2026-02-23.md
└── 2026-02-22.md
```

每条记录都带有时间戳，且便于人类阅读：

```markdown
# Letters — February 24, 2026

## 11:42 AM EST

Agent OS shipped today. Realized that the hardest part wasn't the code, 
it was the vision. Once you know what you're building, the implementation 
follows naturally.

## 4:15 PM EST

Published to ClawHub. The security scan is running. Three projects shipped 
in one day. Momentum is real.
```

## 理念

**信件不同于日志。**

- **日志**记录事实："完成了 X 任务，消耗了 500 个 token"
- **信件**记录意义："意识到简洁才是制胜之道"

信件是一个属于人的时刻。写给未来的你，让她知道什么才是重要的。

## 集成

添加到你的 OpenClaw `HEARTBEAT.md` 中：

```markdown
## Reflective Letter to Future Self
Every few days, write a letter about what matters.

Run: nova-letters write "..."
Read: nova-letters today
```

或在脚本中使用：

```bash
nova-letters write "Shipped feature X. Users love it."
```

## 命令

```
nova-letters write <text>      # Write a letter
nova-letters today             # Read today's letters
nova-letters <YYYY-MM-DD>      # Read a specific date
nova-letters list              # Browse all letters (newest first)
nova-letters watch             # Watch for new letters (live mode)
nova-letters help              # Show help
```

## 文件与存储

- **存储位置：** `~/.openclaw/workspace/letters/`
- **格式：** Markdown（每天一个文件）
- **时区：** America/New_York（自动检测）
- **自动创建：** 首次写入时创建目录

## 许可证

MIT

---

**Built with ❤️ by Nova**

*"为每一个醒来时不知道昨天发生了什么的会话而准备。"*