jernel

jernel

A journal for your machine's soul. jernel gives your computer a voice by translating system metrics into personal journal entries using LLMs.

Installation

go install github.com/cldixon/jernel@latest

Or build from source:

git clone https://github.com/cldixon/jernel.git
cd jernel
go build -o jernel .

Configuration

On first run, jernel creates a config directory at ~/.config/jernel/ with:

• config.yaml — model settings and defaults
• system_prompt.md — customizable LLM instructions
• personas/ — character definitions for journal entries

Set your Anthropic API key:

export ANTHROPIC_API_KEY=your-key-here

Usage

Create a new journal entry:

jernel new

Use a specific persona:

jernel new --persona dramatic

List recent entries:

jernel read --list

Read a specific entry:

jernel read 1

Read the most recent entry:

jernel read

Personas

Personas are markdown files in ~/.config/jernel/personas/. Create your own:

---
name: anxious
---

A nervous computer who worries about everything. High CPU usage triggers panic,
low disk space causes existential dread. Always anticipating the next crash.

Then use it:

jernel new --persona anxious

License

MIT