Angel
Obsidian Plugin & Agent Skill

An angel and a devil read your note and talk it over.

The angel finds concrete things to praise. The devil teases your slips and smuggles in one real, sharp point per turn. Two perspectives on a note you wrote alone.

Devil
Characters

Two readers

Not just praise, not just criticism. The contrast between the two is what makes the insight stick.

Angel

Picks out specific strengths in your note, reframes stumbles in a positive light, and closes by offering one small next step.

Devil

Mocks the gaps, excuses and temptations, and slips in one genuine critique every turn. You'll be laughing right up until it lands.

Demo

See it in action

A replica of the plugin's modal, playing real output from a morning journal note. Click or press Space for the next line.

Angel & Devil 📝 Morning log — expired eggs, a Castella chaser, blank Tasks
Angel
Standby
Devil
Standby

🔊 The same banter read aloud by two voices with Gemini TTS:

Get started

Two ways to use it

Pick the one that fits where you already write. Both use a Gemini API key (free from Google AI Studio).

For Obsidian users

Obsidian plugin

Press the 😇😈 button in the note header. The two trade lines in the same modal as the demo above.

  • Banter about just the selected text
  • Save to the end of the note, and talk back
  • Two-voice read-aloud and memory of past banter

We recommend installing with BRAT: it works inside Obsidian on Windows, macOS, Linux, iOS, and Android, and keeps the plugin up to date. A manual install without BRAT is covered too.

Getting started (install & API key) →
For AI agent users

Agent Skill

A skill for Cursor / Codex-compatible agents that has the angel and devil read notes, documents and web pages.

  • Run /angel-and-devil-note @notes/today.md
  • Or just ask: “have the angel and devil review this note”
  • Optional read-aloud with Gemini TTS
git clone https://github.com/koooyooo/dot-agent-angel-and-devil.git
cd dot-agent-angel-and-devil && ./install.sh
Skill README →
Features

What the Obsidian plugin does

Write, let them read, talk back a little.

🎬

Animated modal

One line per click or Space. Skip to show all, or regenerate.

✂️

Selection only

Select text first and the banter covers just that part.

💾

Save to note

Append the banter as a quote block at the end of the note.

💬

Talk back

Reply once after the banter: the devil answers first, the angel closes.

🔊

Two-voice read-aloud

Gemini TTS gives each character a voice, and the characters move with it.

🧠

Memory

They keep notes, refer back to past banter, and avoid repeating the same point.

Privacy

Privacy

Your note is sent only when you start a banter.

  • Only when you start a banter, the note body (or selection) is sent to the Google Gemini API using your own API key. Nothing is sent at any other time.
  • Frontmatter (YAML) and previously saved banter blocks are stripped before sending.
  • With read-aloud on (off by default), the generated banter text is sent to Gemini TTS. Audio is kept in memory only.
  • Memory (off by default) is stored as ordinary notes inside your vault, not on any external server.

Full disclaimer & privacy details →