← Back to Skills Marketplace
jeremymahieu

Listonic

by Jeremy Mahieu · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
976
Downloads
1
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install listonic
Description
Access Listonic shopping lists: list lists/items, add/check/delete items, and manage lists.
README (SKILL.md)

Listonic

Manage Listonic shopping lists via the unofficial web API.

Setup

Create ~/.openclaw/credentials/listonic/config.json using one auth mode.

Recommended: token mode (works with Google sign-in)

{
  "refreshToken": "your-refresh-token"
}

Tip: the script now auto-refreshes access tokens and persists updated tokens back to config. It also accepts refresh_token / access_token keys if you paste raw OAuth payload JSON.

Optional (advanced):

{
  "accessToken": "short-lived-access-token",
  "clientId": "listonicv2",
  "clientSecret": "fjdfsoj9874jdfhjkh34jkhffdfff",
  "redirectUri": "https://listonicv2api.jestemkucharzem.pl"
}

Fallback: email/password mode

{
  "email": "[email protected]",
  "password": "your-listonic-password"
}

Workflow

  1. lists to show available shopping lists
  2. items \x3Clist> to inspect current items
  3. add-item \x3Clist> "Name" to add items
  4. check-item / uncheck-item to toggle completion
  5. delete-item only when user explicitly wants removal

Important

  • This uses an unofficial reverse-engineered API and may break if Listonic changes it.
  • For destructive operations (delete-item, delete-list), confirm with the user first.
  • list arguments can be list ID or a list name (exact/partial match).

Commands

Show all lists

bash scripts/listonic.sh lists

Show items in a list

bash scripts/listonic.sh items 12345
bash scripts/listonic.sh items "Groceries"

Add item

bash scripts/listonic.sh add-item "Groceries" "Milk"
bash scripts/listonic.sh add-item "Groceries" "Flour" --amount 2 --unit kg

Check / uncheck item

bash scripts/listonic.sh check-item "Groceries" 987654
bash scripts/listonic.sh uncheck-item "Groceries" 987654

Delete item

bash scripts/listonic.sh delete-item "Groceries" 987654

Create / rename / delete list

bash scripts/listonic.sh add-list "BBQ Party"
bash scripts/listonic.sh rename-list "BBQ Party" "BBQ"
bash scripts/listonic.sh delete-list "BBQ"

Raw JSON output

bash scripts/listonic.sh --json lists
bash scripts/listonic.sh --json items "Groceries"
Usage Guidance
This skill appears to do what it says: a local CLI that talks to Listonic and stores your auth in ~/.openclaw/credentials/listonic/config.json. Before installing: (1) Prefer the token/refreshToken mode rather than supplying your email/password. (2) Be aware tokens (and rotated refresh tokens) are saved in plaintext at the given path — avoid placing them on shared machines. (3) Inspect the bundled scripts yourself if you want to confirm network endpoints; the code calls Listonic domains and includes a hard-coded client_id/client_secret and a non-Listonic redirect URI (likely from reverse-engineering). (4) If you are uncomfortable giving credentials, do not add them; the tool cannot work without valid credentials.
Capability Analysis
Type: OpenClaw Skill Name: listonic Version: 1.0.1 The skill is a functional integration for managing Listonic shopping lists using a reverse-engineered API. It handles authentication (OAuth tokens or email/password) and persists refreshed tokens to its own configuration file in `~/.openclaw/credentials/listonic/`. The implementation in `scripts/listonic.py` uses standard Python libraries, lacks suspicious execution or exfiltration logic, and includes safety instructions in `SKILL.md` for destructive operations.
Capability Assessment
✓ Purpose & Capability
Name/description (manage Listonic lists) match the included Python CLI and shell wrapper. Required binary is python3, and the skill reads/writes a per-skill config file for tokens/passwords — all consistent with an API client.
✓ Instruction Scope
SKILL.md instructs creating a local config at ~/.openclaw/credentials/listonic/config.json and running the provided scripts. The runtime instructions and the code operate only on that config path and the Listonic API; they do not request unrelated system files or external endpoints unrelated to Listonic functionality.
✓ Install Mechanism
No external install/downloads are performed. This is an instruction-only skill with bundled code files executed locally. No remote installers, package downloads, or archive extraction are used.
ℹ Credentials
The skill requests no environment variables, only a local credentials file (token or email/password). It persistently stores tokens (including rotated refresh tokens) in plaintext at ~/.openclaw/credentials/listonic/config.json — expected for a client but something users should be aware of. The code includes a hard-coded default client_id/client_secret and a default redirect URI; embedding these values is plausible for a reverse-engineered web client but worth noting.
✓ Persistence & Privilege
always is false and the skill only writes to its own config path. It auto-refreshes and persists tokens for convenience; it does not request system-wide settings or other skills' credentials.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install listonic
  3. After installation, invoke the skill by name or use /listonic
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Added auto-refresh for access tokens and automatic persistence of updated tokens back to the config. - Improved compatibility with OAuth JSON payloads by also accepting refresh_token and access_token keys. - No breaking changes to commands or workflows.
v1.0.0
- Initial release: Manage Listonic shopping lists from the command line using an unofficial API. - Supports listing, adding, checking/unchecking, and deleting items and lists. - Allows flexible authentication via refresh token, access token, or email/password. - Includes JSON output mode and confirmation prompts for destructive actions. - Compatible with both list names and IDs for commands.
Metadata
Slug listonic
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Listonic?

Access Listonic shopping lists: list lists/items, add/check/delete items, and manage lists. It is an AI Agent Skill for Claude Code / OpenClaw, with 976 downloads so far.

How do I install Listonic?

Run "/install listonic" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Listonic free?

Yes, Listonic is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Listonic support?

Listonic is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Listonic?

It is built and maintained by Jeremy Mahieu (@jeremymahieu); the current version is v1.0.1.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments