Devices

Logitech

logitech-docs-pp-cli

Every Logitech manual, spec sheet, and install guide — searchable offline, agent-native, no browser.

Printed by @Drummerms (drummerms)

Install

npx — recommended

npx -y @mvanhorn/printing-press-library install logitech-docs

Installs the CLI binary and the agent skill (Claude Code, Codex, Cursor, Gemini CLI, Copilot, and more). Add --cli-only or --skill-only for one half. Requires Node.

Hermes

hermes skills install mvanhorn/printing-press-library/cli-skills/pp-logitech-docs --force

From the Hermes CLI. Inside a chat session use /skills install with the same path.

OpenClaw

Install the pp-logitech-docs skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-logitech-docs. The skill defines how its required CLI can be installed.

Paste this to your OpenClaw agent — the skill describes how to install its CLI.

Claude Desktop

This CLI ships an MCPB bundle. Download the latest release .mcpb and double-click it — Claude Desktop walks you through the install.

View source on GitHub →

Every Logitech manual, spec sheet, and install guide — searchable offline, agent-native, no browser.

support.logi.com is a Zendesk portal with a clean JSON API hiding behind it. logitech-docs turns 33k+ reference documents into a greppable local index: find specs by product, pull install guides, and full-text search inside manuals without touching a browser.

Authentication

No authentication required. The support site and its Help Center API are public.

Quick Start

# health check, works without credentials
logitech-docs-pp-cli doctor --dry-run

# see the 9 support categories
logitech-docs-pp-cli categories list

# search the live docs
logitech-docs-pp-cli articles search --query "MeetUp"

# pull the spec sheet directly
logitech-docs-pp-cli docs spec "MeetUp"

Unique Features

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

Doc discovery

docs — Search Logitech support docs by friendly type: spec sheet, manual, install guide, FAQ, download, warranty.

Agents reach for this instead of guessing Zendesk label strings for spec sheets vs install guides.
```
logitech-docs-pp-cli docs spec "MeetUp" --agent
```
download — Resolve download01.logi.com file links in an article and fetch them (with --dry-run and local cache).

Scriptable downloads of firmware/software/PDF manuals without clicking through the site.
```
logitech-docs-pp-cli download 360023302754 --dry-run
```

Local state that compounds

find — Full-text search inside synced manuals and spec sheets from the local store.

Search manuals offline, across a product family at once, without the Cloudflare-fronted site.
```
logitech-docs-pp-cli find "camera dimensions" --agent
```
compare — Side-by-side spec comparison between two products from synced spec sheets.

AV integrators compare dimensions and compatibility across products before quoting.
```
logitech-docs-pp-cli compare "MeetUp" "Rally Bar" --agent
```

Recipes

Grab a spec sheet

logitech-docs-pp-cli docs spec "MeetUp" --select title,html_url

narrow a large search response to just name and link

Full-text search inside manuals

logitech-docs-pp-cli docs manual "pairing" --agent --select title,html_url

live full-text search across manual bodies, narrowed for agents

Preview a download

logitech-docs-pp-cli download 360023302754 --dry-run

see the resolved file URL before fetching

Usage

Run logitech-docs-pp-cli --help for the full command reference and flag list.

Paths & environment variables

This CLI separates local files into four path kinds:

Kind	Contents
`config`	User-editable settings such as `config.toml` and saved profiles
`data`	Durable local data such as `data.db`
`state`	Runtime state such as persisted queries, jobs, and `teach.log`
`cache`	Regenerable HTTP/cache files

Each kind resolves independently. The ladder is:

Per-kind env var: LOGITECH_DOCS_CONFIG_DIR, LOGITECH_DOCS_DATA_DIR, LOGITECH_DOCS_STATE_DIR, or LOGITECH_DOCS_CACHE_DIR
--home <dir> for this invocation
LOGITECH_DOCS_HOME for a flat relocated root
XDG env vars: XDG_CONFIG_HOME, XDG_DATA_HOME, XDG_STATE_HOME, XDG_CACHE_HOME
Platform defaults matching existing installs

For containers and agent sandboxes, prefer a single relocated root:

export LOGITECH_DOCS_HOME=/srv/logitech-docs
logitech-docs-pp-cli doctor

Under LOGITECH_DOCS_HOME=/srv/logitech-docs, the four dirs resolve to /srv/logitech-docs/config, /srv/logitech-docs/data, /srv/logitech-docs/state, and /srv/logitech-docs/cache.

MCP servers do not receive CLI flags from the host. Put relocation in the host env block:

{
  "mcpServers": {
    "logitech-docs": {
      "command": "logitech-docs-pp-mcp",
      "env": {
        "LOGITECH_DOCS_HOME": "/srv/logitech-docs"
      }
    }
  }
}

Precedence matters in fleets: an ambient per-kind variable such as LOGITECH_DOCS_DATA_DIR overrides an explicit --home for that kind. Use LOGITECH_DOCS_HOME or the per-kind variables for durable fleet relocation; treat --home as the weaker per-invocation lever.

Relocation is one-way. Unsetting LOGITECH_DOCS_HOME does not move files back to platform defaults, and doctor cannot find files left under a former root. Move the files manually before unsetting relocation variables.

Existing installs keep working because the platform-default rung matches the legacy layout. Run logitech-docs-pp-cli doctor --fail-on warn to check path warnings in automation.

Commands

articles

Support articles: manuals, spec sheets, install guides, FAQs, downloads

logitech-docs-pp-cli articles by-section - List articles in one section (server-side scoped)
logitech-docs-pp-cli articles get - Get a single article including its HTML body
logitech-docs-pp-cli articles list - List articles (filter by label)
logitech-docs-pp-cli articles search - Search articles by text

sections

Product-family sections within the support site

logitech-docs-pp-cli sections - List sections (optionally filtered by category)

Self-learning loop

This CLI caches per-question discovery so repeat queries skip the walk and structurally similar queries get answered via entity substitution. The loop also self-captures: every invocation is journaled locally, and failed-flag corrections plus fresh teaches surface as candidates on the next recall for confirm/reject judgment. Agents call recall before discovery and fire teach & after answering. See the ## Automatic learning section in SKILL.md for the full protocol.

logitech-docs-pp-cli recall <query> - Look up cached resources for a query before running discovery
logitech-docs-pp-cli teach - Record a query -> resource mapping (silent on success, safe to background with &)
logitech-docs-pp-cli learnings list - Inspect taught rows
logitech-docs-pp-cli learnings forget <query> - Undo a teach
logitech-docs-pp-cli learnings candidates - List auto-captured candidates awaiting confirm/reject
logitech-docs-pp-cli learnings stats - Local loop metrics: recall hit rate, teach-to-reuse, playbook resolution, candidate counts
logitech-docs-pp-cli teach-pattern - Install a query/resource template up front
logitech-docs-pp-cli teach-lookup - Add an entity mapping (e.g. country code, team alias) for pattern substitution

Pass --no-learn or set LOGITECH_DOCS_NO_LEARN=true to disable the loop for deterministic flows.

The local store's schema version stamp is one-way: once this version of logitech-docs-pp-cli opens the database, older binaries refuse it with a version error — upgrade the binary rather than downgrading.

Output Formats

# Human-readable table (default in terminal, JSON when piped)
logitech-docs-pp-cli articles list

# JSON for scripting and agents
logitech-docs-pp-cli articles list --json
# Filter to specific fields
logitech-docs-pp-cli articles list --json --select id,name,title

# Dry run — show the request without sending
logitech-docs-pp-cli articles list --dry-run

# Agent mode — JSON + compact + no prompts in one flag
logitech-docs-pp-cli articles list --agent

Agent Usage

This CLI is designed for AI agent consumption:

Non-interactive - never prompts, every input is a flag
Pipeable - --json output to stdout, errors to stderr
Filterable - --select <field>[,<field>...] returns only fields you need
Previewable - --dry-run shows the request without sending
Read-only by default - this CLI does not create, update, delete, publish, send, or mutate remote resources
Offline-friendly - sync/search commands can use the local SQLite store when available
Agent-safe by default - no colors or formatting unless --human-friendly is set

Exit codes: 0 success, 2 usage error, 3 not found, 5 API error, 7 rate limited, 10 config error.

Health Check

logitech-docs-pp-cli doctor

Verifies configuration and connectivity to the API.

Configuration

Run logitech-docs-pp-cli doctor to see the resolved config, data, state, and cache directories. The platform-default config path is ``; --home, LOGITECH_DOCS_HOME, and per-kind env vars can relocate it.

Static request headers can be configured under headers; per-command header overrides take precedence.

Troubleshooting

Not found errors (exit code 3)

Check the resource ID is correct
Run the list command to see available items

API-specific

search returns 404 / RecordNotFound — use the locale-free search form (articles search), not a locale-prefixed path
empty article body in list output — list endpoints omit body; use articles get for the full HTML