Rakkan

by kivisolipse
5
4
3
2
1
Score: 50/100

Description

Every character, signed. Mark which characters were written by you, by an AI, or quoted from elsewhere, with plain-text inline markers.

Reviews

No reviews yet.

Stats

1
stars
68
downloads
0
forks
16
days
8
days
8
days
1
total PRs
0
open PRs
0
closed PRs
1
merged PRs
0
total issues
0
open issues
0
closed issues
95
commits

Latest Version

9 days ago

Changelog

  • Gradient text in two colours. Every built-in family now has a second colour on both themes, so gradient text runs from one to the other instead of showing a single colour. Settings → Model families takes a start and an end colour for each theme. An author line in the book may carry a second · #colour after the first, and Manage authors has a picker for it. Colours set before this release keep showing one colour until an end colour is chosen.
  • Settings follow Obsidian Sync. Settings that Sync brings in from another device apply at once, without restarting Obsidian.

Fixes

  • Rainbow text on iPhone and iPad: no more lag when scrolling or typing. iOS has no fixed backgrounds, so there each line runs through the whole spectrum, and the text column is no longer measured.
  • Rainbow text elsewhere: the text column is measured only when the editor's size changes, not on every scroll.

README file from

Github

Markers

Write Meaning
Plain text Written by you
&&text&& Written by an AI; &&text&&[@gpt] names the model
&& Claude (claude-opus-5-5) … && A whole AI block, each marker on a line of its own
@@text@@ Your own words inside AI text
"text"[@key], 「text」[@key] A quote, credited to an author (a model's quote stays the model's until checked)

Without the plugin, the note still reads as ordinary Markdown. The full syntax is in docs/SPEC.md.

Select text, right-click and choose Rakkan → Mark as AI-generated. What you type inside AI text is marked as yours. Reading view shows only the colours.

Features

  • Colour by model. Each model family has its own colour. Any family or model can use gradient, rainbow (as in iA Writer) or underline instead.
  • Live preview and reading view. Markers hide when the cursor leaves the line; reading view shows only the colours.
  • Status bar. Human 37% · AI 38% · Quotes 25%; hover for the count by model and by author.
  • Signing as you write. Text you type inside AI text is wrapped in @@…@@. Moved lines keep their authors. Copied text leaves the markers behind.
  • Paste revision. Paste an AI's revision of your text; only the changed words are credited to the model.
  • Author book. One note lists every author: - @key: Name (id) · human / AI / source · #colour, with an optional second · #colour where gradient text ends. Quotes take their author's colour.
  • Search that ignores markers, in Obsidian's search, the find bar and Omnisearch.
  • Export to PDF in colour or plain text, to a note without markers, to Pandoc, to Obsidian Publish, and to and from iA Writer's Markdown Annotations.
  • Web Clipper templates: pages clipped with Obsidian Web Clipper are saved as signed quotes, with an optional AI summary signed by the model that wrote it.
  • English and Chinese interface.

A detailed guide is in docs/GUIDE.md.

For AI agents

Rakkan comes with an Agent Skill that teaches an agent to sign what it writes: paragraphs in an AI block signed with its model ID, a few words inline, and the author's own markers left as they are.

npx skills add Kivisolipse/Rakkan

Or copy skills/rakkan into your agent's skills folder (~/.claude/skills/ for Claude Code). For an agent without skills, paste the body of SKILL.md into its instructions, such as AGENTS.md or CLAUDE.md.

The skill brings a small command that the agent runs itself, with Node.js 18 or later. rakkan sign marks exactly the characters the agent changed in your text, with the same diff as Paste revision. rakkan lint checks a note for markers that don't work: blocks left open, markers without a partner, [@key] that nothing defines. Without the skill, npx rakkan lint path/to/notes runs it too.

What the agent writes looks like this:

&& Claude (claude-opus-5-5)

Paragraphs the agent wrote.

&&

A sentence of yours, with &&a few words the agent changed&&[@claude-opus-5-5].

Install

Requires Obsidian 1.8.7 or later, on desktop or mobile.

Rakkan is in Obsidian's community plugins. In Settings → Community plugins, select Browse, search for "Rakkan", then select Install and Enable.

By hand. Download main.js, manifest.json and styles.css from the latest release, put them in <vault>/.obsidian/plugins/rakkan/, and enable Rakkan in Settings → Community plugins.

Privacy

Rakkan makes no network requests and collects no data.

  • Clipboard. Rakkan reads the clipboard only when you run Paste as AI-generated, Paste as quote or Paste revision. When you copy, it puts the text on the clipboard without markers.
  • Vault. It lists the notes in your vault only to search them while ignoring markers.
  • PDF. On desktop, Export as PDF prints through Electron, as Obsidian's own Export to PDF does. It saves the file where you choose in the save dialog, which may be outside your vault.

Development

npm install
npm test
npm run build   # writes main.js
npm run demo    # builds and installs into demo-vault/
npm run fuzz    # the property-based tests at full length

Besides the unit tests, a property-based fuzz suite checks the parser, signing, quoting and Clarify quote against random text built from Rakkan's and Markdown's syntax: 16 properties, each run 100 000 times before a release.

License

MIT. Inspired by iA Writer's Authorship. Bundles monkey-around by PJ Eby (ISC).