cli-anything-joplin — скилл для Claude Code
Скилл cli-anything-joplin для Claude Code управляет заметками, блокнотами, задачами и тегами Joplin через терминальный бэкенд. Агент экспортирует данные и синхронизирует проект без GUI.
Apache-2.0 299 установок ★ 62 125 обновлён 2026-09-22
npx skills add HKUDS/CLI-Anything --skill cli-anything-joplin -a claude-codeЧто делает cli-anything-joplin
Скилл оборачивает терминальную версию Joplin в Python-обёртку с поддержкой состояния проекта: агент выполняет команду через cli-anything-joplin, получает JSON с полями ok, command, data и error, и может сохранить проект в файл для многоступенчатых сценариев.
Включает группы команд для работы с блокнотами (notebooks list, create, use), записями (notes create, set, get, move, rename), задачами (todos toggle, clear, done), тегами (tags add, remove), поиском (search run), синхронизацией (sync run --target), импортом и экспортом (interop import, export), настройками (config get, set), вложениями (attach add), шифрованием (e2ee decrypt) и управлением проектом (project new, save, status). Нужен Python 3.10+ и бинарник joplin в PATH; поиск работает только в GUI-версиях Joplin — в CLI может вернуть «only available in GUI mode». В Joplin 3.6.x на npm команда version сломана, скилл извлекает версию из метаданных пакета, проверяя симлинк бинарника, соседний node_modules/joplin, родительский lib/node_modules/joplin и npm root -g.
Агенту рекомендуется использовать флаг --json для парсинга, --project для сохранения истории в многоступенчатых задачах, --dry-run для тестового запуска без сохранения. REPL-режим не сохраняет проект автоматически — агент вызывает project save явно.
Какие задачи решает
- автоматизировать создание заметок и блокнотов в Joplin
- экспортировать записи и настройки Joplin без GUI
- переключать статус задач и применять теги
- синхронизировать проект Joplin по команде агента
- запустить поиск или импорт данных через CLI
Примеры запросов агенту
- Создай блокнот
Meetingsв Joplin и добавь туда заметку «Standup 12.01». - Выполни команду
cli-anything-joplin --json notes listи покажи все записи. - Переключи задачу с тегом
urgentв состояние done.
Как установить cli-anything-joplin
1Через Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-joplin -a claude-code2Вручную: положить файлы
~/.claude/skills/cli-anything-joplin/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cli-anything-joplin/
1Через Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-joplin -a codex2Вручную: положить файлы
.agents/skills/cli-anything-joplin/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-joplin -a cursor2Вручную: положить файлы
.cursor/skills/cli-anything-joplin/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install HKUDS/CLI-Anything skills/cli-anything-joplin2Вручную: положить файлы
.github/skills/cli-anything-joplin/SKILL.md1Через Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-joplin -a gemini-cli2Командой платформы
gemini skills install https://github.com/HKUDS/CLI-Anything --path skills/cli-anything-joplinВручную: положить файлы
.devin/skills/cli-anything-joplin/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-joplin -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о cli-anything-joplin
Как установить cli-anything-joplin в Claude Code?
Выполни npx skills add HKUDS/CLI-Anything --skill cli-anything-joplin -a claude-code, файл скилла окажется в ~/.claude/skills/cli-anything-joplin/SKILL.md.
Что делает cli-anything-joplin?
Даёт агенту управлять записями, блокнотами, задачами, тегами и синхронизацией Joplin через CLI. Скилл запускает команды терминального бэкенда joplin, получает JSON-ответ и сохраняет состояние проекта в файл для многоступенчатых задач.
Нужен ли GUI Joplin для работы скилла?
Нет, скилл работает с терминальным бинарником joplin без GUI. Но команда search run требует GUI-версию — в чистом CLI она вернёт ошибку «only available in GUI mode».
Исходный текст
SKILL.md · Apache-2.0
---
name: "cli-anything-joplin"
description: "Command-line interface for Joplin workflows using the real joplin terminal backend"
---
# cli-anything-joplin
Use this skill to automate Joplin notebook, note, to-do, tag, attachment,
search, sync, and import/export workflows through a stateful harness backed by
the real `joplin` terminal binary.
## Requirements
- Python 3.10+
- Joplin terminal binary available as `joplin`
- Optional: pass `--profile` to target a specific Joplin profile
## Install
```bash
cd joplin/agent-harness
pip install -e .
```
## Usage
```bash
# REPL mode (default)
cli-anything-joplin
# Machine-readable one-shot command
cli-anything-joplin --json notebooks list
# Stateful project
cli-anything-joplin project new --name demo -o ./demo.joplin-harness.json
cli-anything-joplin --project ./demo.joplin-harness.json notes create "Meeting note"
# Dry-run (no auto-save)
cli-anything-joplin --json --dry-run --project ./demo.joplin-harness.json notes create temp
```
## JSON output contract
When `--json` is enabled, commands return:
- `ok`: boolean
- `command`: stable command identifier such as `notes.list`, `todos.toggle`
- `data`: command payload
- `error`: null on success, or `{ type, message }` on failure
## Command groups
- `project`: `new`, `open`, `save`, `info`, `json`, `status`
- `notebooks`: `list`, `create`, `use`, `remove`
- `notes`: `list`, `create`, `set`, `get`, `remove`, `copy`, `move`, `rename`
- `todos`: `list`, `create`, `toggle`, `clear`, `done`, `undone`
- `tags`: `list`, `add`, `remove`, `notetags`, `tagnotes`
- `search`: `run`
- `sync`: `run` (`--target`, `--upgrade`, `--use-lock`)
- `interop`: `import`, `export`
- `config`: `get`, `set`, `list`, `export`, `import-file`
- `attach`: `add`
- `status`: `show`, `restore`
- `backend`: `version`, `dump`, `keymap`, `geoloc`, `export-sync-status`
- `server`: `status`, `start`, `stop`
- `e2ee`: `status`, `target-status`, `decrypt`, `decrypt-file`
- `session`: `status`, `undo`, `redo`, `history`
## Agent guidance
- Prefer `--json` for parseable output.
- Use `--project` when running multi-step workflows so history is persisted.
- One-shot mutating commands auto-save the project unless `--dry-run` is set.
- REPL mode does not auto-save; run `project save` explicitly.
- Some Joplin CLI builds gate `search` behind GUI mode; if you see
`"only available in GUI mode"`, treat search as best-effort.
- Joplin 3.6.x can have a broken `version` command in npm global layouts; the
harness falls back to installed package metadata for `backend version`,
probing the symlink-resolved binary directory, the Windows-style sibling
`node_modules/joplin`, the Unix-style parent `lib/node_modules/joplin`, and
finally `npm root -g`.
- Backend `stdout`/`stderr` in command results are verbatim; do not assume
warnings were stripped from note bodies or exports.
- On failure, parse `error` using the same `command` field as success
(`config.import_file`, `e2ee.decrypt_file`). Multi-word subcommands use
a single dot between group and subcommand.
## Test workflow
```bash
# Quick feedback loop
python -m pytest -q cli_anything/joplin/tests/test_core.py
python -m pytest -q cli_anything/joplin/tests/test_full_e2e.py::TestCLISubprocess
# Real backend (joplin must be in PATH)
python -m pytest -v cli_anything/joplin/tests/test_full_e2e.py::TestBackendCommands
python -m pytest -v cli_anything/joplin/tests/test_full_e2e.py::TestBackendWorkflows
python -m pytest -v cli_anything/joplin/tests/test_full_e2e.py::TestBackendIntegration
# Full suite
python -m pytest -v --tb=no cli_anything/joplin/tests
# Verify the installed console script entry point
CLI_ANYTHING_FORCE_INSTALLED=1 python -m pytest -v -s cli_anything/joplin/tests/test_full_e2e.py
```
Current validation baseline (Windows + Joplin CLI 3.6.2):
- `python -m pytest -q cli_anything/joplin/tests/test_core.py` -> `107 passed`
- `python -m pytest -q cli_anything/joplin/tests` -> `134 passed, 1 skipped`
© HKUDS · Apache-2.0 · HKUDS/CLI-Anything