By lutencjusz
Listy zakupów Listonic w Claude Code: odczyt/edycja list, własna historia zakupów i ranking popularnych produktów. Skille + backend CLI w Pythonie.
Zapis na listach Listonic — dodaj pozycję, odhacz, cofnij odhaczenie, usuń. Wyzwalacze: "dodaj do listy zakupów", "odhacz na listonic", "usuń z listy", "kupiłem X".
Historia i statystyki zakupów Listonic — zrzuca odhaczone pozycje do vaultu i pokazuje popularne produkty. Wyzwalacze: "zsynchronizuj historię zakupów", "co kupuję najczęściej", "popularne produkty", "statystyki zakupów".
Odczyt list zakupów Listonic — pokazuje listy, pozycje, status odhaczenia. Wyzwalacze: "co mam na liście zakupów", "pokaż listonic", "co zostało do kupienia", "co już odhaczone".
Instalacja i konfiguracja pluginu Listonic — instaluje CLI przez uv tool, zapisuje credentials i weryfikuje logowanie. Wyzwalacze: "skonfiguruj listonic", "zaloguj do listonic", "instalacja listonic".
🇵🇱 Wersja polska: README_PL.md
A Claude Code plugin for managing Listonic shopping lists — straight from a conversation with Claude. It provides skills to read and edit lists, builds your own history of checked-off purchases dumped into an Obsidian vault, and ranks your most frequently bought products.
Under the hood it runs a Python CLI backend (listonic) that talks to the Listonic API.
The plugin is skills and a CLI backend — install both.
# 1) Skills — Claude Code marketplace
/plugin marketplace add lutencjusz/listonic-plugin
/plugin install listonic-plugin@listonic-plugin
# 2) CLI backend (the `listonic` binary)
uv tool install git+https://github.com/lutencjusz/listonic-plugin.git
Skipping step 2 is the most common cause of "I installed it but it doesn't work" — the skills call the CLI.
listonic login # prompts for email and password interactively
Tokens are stored in ~/.listonic/config.json — outside the repository and the vault.
Don't pass passwords as arguments (they stay in shell history) — interactively only.
For non-interactive use (cron/CI), login also reads LISTONIC_EMAIL and
LISTONIC_PASSWORD from the environment (falling back to the interactive prompts when
unset). Keep these in a file with restricted permissions (e.g. chmod 600), never in the
repo:
set -a; . ./.listonic.env; set +a # exports LISTONIC_EMAIL / LISTONIC_PASSWORD
listonic login
"Sign in with Google" accounts: the CLI uses email + Listonic password login only
(not Google OAuth). If you created your account through Google, first set a Listonic
password in the app/web (account settings → set/change password, or "forgot password" for
the same email), then log in with your Google email + that Listonic password.
The listonic-history skill writes checked-off items into an Obsidian vault and generates
a ranking of popular products. Point it at your vault once in ~/.listonic/config.json:
{ "vault_path": "/path/to/Vault" }
Without vault_path, the sync-history/popular commands report a missing path; plain
lists/add/check work without it. By default history goes to
<vault>/Google Keep/Zakupy/ (directory configurable via zakupy_dir).
If you have an always-on server, history sync can run there (cron) while the local machine
only pulls the ready files: listonic sync-history --pull-only. The connection is read
from ~/.mikrus/config.json; when it's missing, the pull step is silently skipped.
listonic lists [--checked|--unchecked] [--json]
listonic add "<list>" "<item>"
listonic check "<list>" "<item>" [--uncheck]
listonic remove "<list>" "<item>"
listonic sync-history [--prune] [--pull-only]
listonic popular [--top N] [--json]
listonic stats [--json]
~/.listonic/config.json, never in the repo.CLIENT_ID/CLIENT_SECRET in the code are the
Listonic app's OAuth client constants (required for the API to respond) — they are not
account credentials.add/check/remove, --prune) modify real lists — the
listonic-edit skill asks for confirmation before writing.MIT — see LICENSE.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
npx claudepluginhub lutencjusz/listonic-plugin --plugin listonic-pluginObsługa hostingu home.pl: komendy przez SSH, transfer plików SFTP i poczta IMAP/SMTP.
Obsługa serwera VPS Mikrus: komendy przez SSH, transfer plików (SCP) i operacje przez API mikr.us.
Skrzynka Gmail przez IMAP/SMTP: odczyt/wyszukiwanie, wysyłka i drafty.
Obsługa Google NotebookLM z Claude Code: zarządzanie notebookami, dodawanie źródeł, pytania z cytatami i pobieranie transkryptów (backend CLI notebooklm-py).
Ultra-compressed communication mode. Cuts ~75% of tokens while keeping full technical accuracy by speaking like a caveman.
Frontend design skill for UI/UX implementation
Comprehensive UI/UX design plugin for mobile (iOS, Android, React Native) and web applications with design systems, accessibility, and modern patterns
Memory compression system for Claude Code - persist context across sessions
Marketing skills for AI agents — conversion optimization, copywriting, SEO, paid ads, ad creative, and growth
Standalone image generation plugin using Nano Banana MCP server. Generates and edits images, icons, diagrams, patterns, and visual assets via Gemini image models. No Gemini CLI dependency required.