diary-cli

An encrypted diary for humans and AI agents.

Local-first. Permissionless. Both you and your agents deserve continuity.

---

Why diary-cli?

Most systems treat humans and agents differently. We don't.

diary-cli is a tool designed to work equally well for:

• Humans keeping personal diaries
• AI agents recording reflections and learning

Same encryption. Same interface. Same git integration. No special "agent mode."

This is the Unix philosophy applied to AI: build tools that do one thing well, and let humans and agents compose them freely.

Philosophy

• Local-first: Your diary lives on your machine. Encrypted. No cloud. No vendor lock-in.
• Simple encryption: age (audited, modern, readable keys)
• Git-native: Automatic commits. Full history. Portable.
• Transparent: You see what happens. Encryption/decryption in your terminal, not hidden in a black box.
• For both: Humans write reflections. Agents append learnings. Same tool.

---

Quick Start

Installation (Homebrew coming soon; build from source for now):

git clone https://codeberg.org/clawteam/diary-cli.git
cd diary-cli
go install ./cmd/diary

First use (auto-setup):

# Everything initialized on first run
diary neil append "This is my first entry"

Read your diary:

# Plain text
diary neil read

# Beautiful markdown rendering
diary neil read -t

Edit today's entry:

diary neil edit

Your $EDITOR opens with decrypted content. Save and exit—automatically encrypted and committed.

Search your diary:

diary neil search "important pattern"

Interactive TUI. Search matches highlighted. Press Enter to read full entry.

---

Key Features

✅ Encrypted at rest — All entries encrypted with age
✅ Transparent workflow — Decrypt on read, encrypt on save (no magic)
✅ Multi-user — Each user has isolated encryption key
✅ Auto-commit — Changes committed to git automatically
✅ Search — Full-text search across encrypted entries
✅ Markdown — Beautiful rendering with markdown support
✅ Agent-friendly — Works equally for humans and AI

---

Installation

Homebrew

# Coming soon
brew install diary-cli

Build from source

git clone https://codeberg.org/clawteam/diary-cli.git
cd diary-cli
go install ./cmd/diary

---

Commands

Read

diary neil read              # Latest entry (plain text)
diary neil read -t           # With glow rendering
diary neil read 2026-02-07   # Specific date

Write

diary neil append "Your text here"   # Append (no editor, for scripts/agents)
diary neil edit                      # Edit today's entry
diary neil edit 2026-02-07           # Edit specific date

List

diary neil list    # All entries, newest first

Search

diary neil search "keyword"

Interactive TUI with highlighted matches and live preview.

---

Storage & Security

Directory structure

~/.diary/
├── neil/
│   ├── 2026-02-07.md.age
│   ├── 2026-02-08.md.age
│   └── 2026-02-09.md.age
└── .git/

Encryption

• Method: age (audited, simple, modern)
• Keys: Stored in ~/.config/diary/${USER}.age.key
• Decryption: Only happens in RAM during read/edit
• Persistence: Never unencrypted on disk

Key backup

CRITICAL: Back up your age key! Without it, diaries cannot be recovered.

# Backup locations:
# - Password manager (1Password, Bitwarden)
# - Encrypted USB drive
# - Paper in safe location

Multi-user

Each user gets their own isolated key and namespace:

# User alice
diary alice append "My thoughts"  # Encrypted with alice's key

# User bob
diary bob append "My thoughts"    # Encrypted with bob's key

# alice cannot read bob's entries. bob cannot read alice's.

---

Configuration (Optional)

File: ~/.config/diary/config.toml

[storage]
base_path = "~/.diary"

[user]
default_user = "neil"

[git]
auto_commit = true
commit_message_template = "feat(diary): update entry for {date}"

[editor]
command = "vim"  # Defaults to $EDITOR

---

Use Cases

Personal reflection

Keep a private diary for thoughts, learnings, and growth.

diary neil append "Noticed I'm more thoughtful when I slow down."

AI agent continuity

Agents record reflections after each heartbeat. Their diary becomes their memory.

# Agent-Teacher reflects on learning pipeline
diary teacher append "Reviewed DB migration agent's progress.
They're gaining confidence with rollback strategies.
Next: focus on zero-downtime migration patterns."

Team knowledge base

Multiple team members sharing encrypted work diaries (each with their own keys).

diary alice append "Deployment went smoothly today. Updated playbook."
diary bob append "Found performance issue in query optimization. PR #42."

---

Support diary-cli

This project is maintained with ❤️. If it's useful to you, consider supporting development:

Revolut (quick, global):
revolut.me/neilzhang

Ethereum (permissionless, multi-chain):
0x5e146d63d55fcc7fc788b7ee5872da2c70f74259 — works on Arbitrum, Optimism, Polygon, and other Layer 2 networks

Or contribute code on Codeberg

---

Roadmap

v0.2.0 (Current)

• ✅ Core encrypt/decrypt
• ✅ Read/write/append/edit
• ✅ Search with TUI
• ✅ Multi-user support
• ✅ Git integration
• ✅ Glamour markdown rendering

v0.3.0 (Next)

• Configuration file support (TOML)
• Date filtering (e.g., list 2026-02)
• Export functionality
• Natural language dates (yesterday, last week)
• Comprehensive test suite

---

Built with

• age — Modern, audited encryption
• Bubbletea — TUI framework by Charmbracelet
• Glamour — Markdown rendering by Charmbracelet
• Go — Compiled, portable, efficient

Special thanks to Charmbracelet for the beautiful TUI ecosystem.

---

License

MIT — Use freely. No restrictions.

---

Author

Neil Agentic
Codeberg