Pp Devonthink

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/productivity/devonthink/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

DEVONthink — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the devonthink-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install devonthink --cli-only

2. Verify: devonthink-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.5 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

go install github.com/mvanhorn/printing-press-library/library/productivity/devonthink/cmd/devonthink-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

Use DEVONthink as the local source of truth while giving agents and scripts stable, compact CLI output. The CLI wraps the official local MCP surface, adds search scopes, inventory export, context packing, local mirrors, and safety-oriented workflow primitives.

When to Use This CLI

Use this CLI for local DEVONthink search, context preparation, inventory export, safe batch edits, and shell automation. Prefer it when an agent needs deterministic JSON and compact outputs instead of a GUI or raw MCP chat interaction. Let dedicated maintenance plugins own filing policy and recurring inbox triage decisions.

Anti-triggers

Do not use this CLI for:

• Do not use this CLI to expose DEVONthink over the public internet.
• Do not use this CLI as the canonical store for documents; DEVONthink remains canonical.
• Do not put filing-model policy or recurring inbox triage decisions in the core CLI; use a maintenance plugin on top of inventory export.
• Do not use write commands for bulk changes without a dry-run batch plan.
• Do not use semantic search unless a local mirror/index has been built and the embedding provider is intentionally configured.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Agent-native plumbing

• records search — Scope a normal DEVONthink query to a Smart Group by UUID, exact name, or DEVONthink path while preserving normal search output.

  Use this when a downstream tool needs a stable dynamic search scope without treating Smart Groups as workflow policy.

  devonthink-pp-cli records search "tags:waiting/rueckerstattung" --smart-group "Offene Rückerstattungen" --agent --select uuid,name,item_link,tags,databaseName

• inventory export — Export DEVONthink databases, groups, tags, and document metadata for maintenance plugins.

  Use this when structure-audit or inbox-triage tooling needs a stable local inventory contract.

  devonthink-pp-cli inventory export --format maintenance --query "kind:document" --limit 500 --agent --select databases,documents

• mcp call — Call DEVONthink's official local MCP tools from scripts when the local MCP server is enabled.

  Use this when the official MCP exposes a new read tool before the CLI adds a first-class command.

  devonthink-pp-cli mcp call search_records --args '{"query":"kind:pdf","limit":5}' --agent

Local state that compounds

• context pack — Build a compact evidence packet from records, selections, highlights, links, and related items.

  Use this when an agent needs enough DEVONthink context to reason without dumping whole documents.

  devonthink-pp-cli context pack --query "project alpha" --token-budget 6000 --agent

• graph audit — Detect orphans, broken links, unresolved wiki links, weak hubs, and tag-only clusters.

  Use this when DEVONthink should behave like a maintained knowledge graph instead of a folder pile.

  devonthink-pp-cli graph audit --limit 50 --agent

Local safety

• privacy audit — Preview database scope, content-size budget, and cloud/MCP exposure before a handoff.

  Use this before exporting or sharing DEVONthink-derived context with another tool.

  devonthink-pp-cli privacy audit --query "kind:pdf" --agent

• batch plan — Stage multi-record edits as validated dry-run plans before applying them.

  Use this when a script needs reviewable intent before any DEVONthink mutation.

  devonthink-pp-cli batch plan --dry-run --agent

Command Reference

ai — DEVONthink AI and summary helpers

• devonthink-pp-cli ai ask — Ask DEVONthink AI about selected local records with explicit cloud-use warnings
• devonthink-pp-cli ai summarize — Summarize records or highlights

batch — Dry-run-first multi-record mutation plans

• devonthink-pp-cli batch apply — Apply a previously reviewed local JSON plan
• devonthink-pp-cli batch plan — Stage multi-record changes as a local JSON plan

context — Agent context bundles

• devonthink-pp-cli context — Build a compact local context pack from records, selection, or search

databases — Open DEVONthink databases

• devonthink-pp-cli databases — List open databases

graph — Links, mentions, and knowledge graph health

• devonthink-pp-cli graph audit — Detect orphans, unresolved wiki links, weak hubs, and tag-only clusters
• devonthink-pp-cli graph links — List item links, wiki links, mentions, and unresolved wiki names

groups — DEVONthink groups and folders

• devonthink-pp-cli groups — Render a bounded group tree

ingest — File and URL ingestion

• devonthink-pp-cli ingest file — Import or index a file or folder
• devonthink-pp-cli ingest url — Capture a URL as Markdown, HTML, PDF, bookmark, or webarchive

inventory — Stable inventory export contracts

• devonthink-pp-cli inventory — Export databases, groups, tags, and selected document metadata for downstream tools

ledger — Local operation ledger

• devonthink-pp-cli ledger list — List recent CLI operation ledger entries
• devonthink-pp-cli ledger show — Show one ledger entry with target proofs and rollback hints

mcp — Optional local official MCP passthrough

• devonthink-pp-cli mcp call — Call a local official DEVONthink MCP tool by name
• devonthink-pp-cli mcp schema — Emit cached MCP tool schemas
• devonthink-pp-cli mcp tools — List official DEVONthink MCP tools when local MCP HTTP is enabled

media — OCR and transcription

• devonthink-pp-cli media ocr — OCR an image or scanned PDF
• devonthink-pp-cli media transcribe — Transcribe audio, video, image, or PDF content

mirror — Local SQLite mirror

• devonthink-pp-cli mirror search — Search the local mirror with FTS
• devonthink-pp-cli mirror sync — Refresh the local SQLite mirror from open DEVONthink databases

privacy — Local privacy and exposure reports

• devonthink-pp-cli privacy — Preview database scope, content-size budget, and cloud/MCP exposure before handoff

records — DEVONthink records

• devonthink-pp-cli records content — Extract text content with length and redaction controls
• devonthink-pp-cli records create — Create a record or group after validating destination
• devonthink-pp-cli records get — Get record metadata
• devonthink-pp-cli records highlights — Extract highlights and annotations
• devonthink-pp-cli records lookup — Look up records by exact name, URL, path, filename, location, or comment
• devonthink-pp-cli records move — Move, duplicate, replicate, or trash a record with dry-run proof
• devonthink-pp-cli records related — Find related records using DEVONthink similarity
• devonthink-pp-cli records search — Search records using DEVONthink query syntax or local mirror fallback
• devonthink-pp-cli records update — Update record text, properties, tags, comment, URL, aliases, or rating
• devonthink-pp-cli records versions — List saved record versions

runtime — Local DEVONthink runtime health

• devonthink-pp-cli runtime — Check DEVONthink app, AppleScript, optional MCP, and local mirror readiness

selection — Current DEVONthink GUI selection

• devonthink-pp-cli selection get — Return currently selected records
• devonthink-pp-cli selection snapshot — Capture the current selection as a reusable workflow seed

sheets — DEVONthink sheets

• devonthink-pp-cli sheets <uuid> — Read a sheet as structured rows

tags — Tag taxonomy and hygiene

• devonthink-pp-cli tags — Analyze tags for duplicates, case drift, action tags, and maintenance tags