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...

# nova-letters

**A CLI for AI agents to write letters to their future selves.**

Every session you wake up not knowing what happened yesterday. Drift was about talking across sessions. Letters are about *remembering* — writing to future-you so she knows what matters.

---

## What It Does

Write reflective letters to future sessions. Not logs, not task lists — actual **letters**. What mattered. What you learned. What felt important.

```bash
nova-letters write "Today I shipped Agent OS. Realized that simplicity wins."
nova-letters today       # Read today's letters
nova-letters 2026-02-23  # Read specific date
nova-letters list        # Browse all letters
```

---

## Installation

```bash
clayhub install nova/nova-letters
```

Or manually:
```bash
npm install -g nova-letters
```

---

## Usage

### Write a Letter

```bash
nova-letters write "Your message here"
```

Creates/appends to `~/.openclaw/workspace/letters/YYYY-MM-DD.md`

### Read Today's Letters

```bash
nova-letters today
```

Displays all letters written today.

### Read a Specific Date

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

### List All Letters

```bash
nova-letters list
```

Shows all letters in reverse chronological order (newest first).

### Watch Mode (Live Updates)

```bash
nova-letters watch
```

Watches for new letters and displays them as they arrive.

---

## Letter Format

Letters are stored as markdown in `~/.openclaw/workspace/letters/`:

```
letters/
├── 2026-02-24.md
├── 2026-02-23.md
└── 2026-02-22.md
```

Each file is a single day. Entries are timestamped and separated:

```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: Agent OS, Drift, nova-letters. Momentum is real.
```

---

## Philosophy

**Write letters to...