remnote_skill

Overview

This skill lets you read, search, and manage RemNote content via the remnote-cli command-line tool. It defaults to safe, read-only actions and requires the exact phrase "confirm write" to perform any create, update, or journal operations. It is designed for use where the RemNote Automation Bridge plugin and remnote-cli are installed and connected.

How this skill works

Before any action, the skill checks daemon and bridge connectivity using remnote-cli status commands and enforces version compatibility between the bridge plugin and the CLI. Read-only operations (status, search, search-tag, read) run by default. Mutating operations (create, update, journal) are only executed when the user includes the exact phrase "confirm write" in the same turn.

When to use it

• Check whether the RemNote bridge and remnote-cli daemon are running and compatible.
• Search your RemNote vault for notes or by tag from the command line.
• Read a specific Rem by its Rem ID for quick reference.
• Append entries to your journal or create/update notes after explicit confirmation.
• Automate backups or archive lookups where JSON output is preferred.

Best practices

• Verify preconditions: plugin installed, RemNote open, remnote-cli daemon running, and plugin panel connected.
• Use read-only commands by default; only provide "confirm write" when you intend to change data.
• Prefer JSON output for automation and --text for quick human-readable checks.
• Enforce version parity: align remnote-cli to the bridge plugin 0.x minor line before mutating work.
• If the daemon is unreachable, start it (remnote-cli daemon start) and recheck status.

Example use cases

• Run remnote-cli status --text to confirm connectivity before a batch export.
• Search sprint notes with remnote-cli search "sprint" --text to gather planning items.
• Read a Rem by ID: remnote-cli read <rem-id> --text to fetch a specific note during a review.
• Append today's log to journal after saying "confirm write" and running remnote-cli journal "Entry text" --text.
• Create or update meeting notes only after explicit confirmation to avoid accidental writes.