skills.rest
HKUDS
HKUDSOFFICIAL
Explore all skills by this author →
WebsiteGitHub

cli-anything-joplin

Automates Joplin notebook, note, to-do, tag, sync, and import/export workflows via the joplin terminal backend.

48.8k|4.5k|Updated Mar 8, 2026
Search Tags:#note-taking#CLI#Automation#JSON output#agent harness#Sync#Joplin
One-click install
npx skills add https://github.com/HKUDS/CLI-Anything --skill cli-anything-joplin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cli-anything-joplin
Source: https://github.com/HKUDS/CLI-Anything/tree/main/joplin/agent-harness/cli_anything/joplin/skills
Command: npx skills add https://github.com/HKUDS/CLI-Anything --skill cli-anything-joplin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing Joplin notes, notebooks, to-dos, tags, and sync operations manually through the terminal is repetitive and hard to script reliably, especially when agents need structured, parseable output and persistent multi-step state.

Core Features & Use Cases

  • Full Joplin workflow automation: Create, edit, move, rename, and search notes and notebooks; manage to-dos, tags, and attachments through a stateful CLI harness backed by the real joplin binary.
  • Machine-readable JSON contract: Every command returns a stable ok/command/data/error structure, making output safe for agents and scripts to parse.
  • Stateful projects with undo/redo: Persist session history in a project file, with dry-run support, auto-save on one-shot mutations, and explicit save in REPL mode.
  • Use Case: An agent can create a project, spin up a notebook, add meeting notes, tag them, attach files, and sync to a configured target — all through --json one-shot commands whose results are programmatically verified.

Quick Start

Ask the agent to use the cli-anything-joplin skill to create a new project and add a note titled "Meeting note" with JSON output enabled.

Frequently Asked Questions about cli-anything-joplin

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Joplin notes from the command line?▼

Install the harness with pip install -e . from the agent-harness directory, then run cli-anything-joplin with subcommands like notes create, notebooks list, or todos toggle. Add --json for machine-readable output and --project to persist state across commands.

How to get JSON output from Joplin CLI commands?▼

Pass the --json flag to any cli-anything-joplin command. Responses follow a stable contract with ok, command, data, and error fields, so scripts and agents can parse results and failures reliably.

Does the Joplin CLI harness require the Joplin desktop app?▼

It requires the Joplin terminal binary available as joplin in PATH, not the desktop GUI. Python 3.10 or newer is also required, and you can pass --profile to target a specific Joplin profile.

Why does Joplin search say only available in GUI mode?▼

Some Joplin CLI builds gate the search command behind GUI mode, so the harness treats search as best-effort. If you see that message, use notes list or tags filtering as an alternative retrieval path.

Can I test Joplin CLI commands without saving changes?▼

Yes, use the --dry-run flag with one-shot mutating commands to prevent auto-save. In REPL mode nothing auto-saves anyway; run project save explicitly when you want to persist changes.

Related Skills

Explore More Software Engineering Skills→
Yapie0Yapie0
55

apple-notes

Manage Apple Notes from terminal via memo CLI with CRUD, search and export to HTML/Markdown.

Community
Intermediate
anyekoutouminganyekoutouming
2

doc-recap-writing

Organize Xiaohongshu topic planning, publishing, and recap workflows into reusable prompts and notes.

Community
Intermediate
unicorn-pluginsunicorn-plugins
21

monitor-sync-status

Detects synchronization gaps between code files and their corresponding documentation.

Official
Intermediate
wangyouanwangyouan

joplin-notes

Manage local Joplin notes via the Joplin Web Clipper API.

Community
Intermediate