goofansu/mlwcli

Overview

This skill provides a unified command-line interface to manage Miniflux feeds, Linkding links, and Wallabag pages from the terminal. It centralizes authentication, listing, adding, and saving operations so you can interact with all three services using consistent commands. It is built in Go for fast, portable CLI usage.

How this skill works

The tool exposes interactive authentication via a TUI that lets you select a service and securely store credentials. It offers domain-specific commands: link, feed, entry, and page, with consistent list/add/save actions and JSON-friendly output flags (--json, --jq). List commands return a {total, items} structure and support pagination and search filters appropriate to each service.

When to use it

• Manage RSS feeds in Miniflux from terminal (add, list, inspect entries)
• Add and organize bookmarks in Linkding with notes and tags
• Save and archive web pages to Wallabag, with tag and archive options
• Automate or script bulk exports and queries using --jq or --json flags
• Interactively authenticate to any of the three services and persist credentials securely

Best practices

• Use auth login/logout TUI for secure credential handling and normalized endpoints
• Always check total vs. returned items before processing to ensure complete results
• Use the proper pagination flags: --limit/--offset for link/entry, --page/--per-page for pages
• Prefer --jq for inline filtering and transformations; use --json to restrict fields for scripting
• Wrap values containing double quotes in single quotes and provide tags as a space-separated quoted string

Example use cases

• Fetch unread feed entries and save selected items to a read-later service via entry save
• Add a new RSS feed and assign it to a category with --category-id
• Bulk-export link titles and URLs using link list --json=id,url | jq '.'
• Archive and tag a set of articles in Wallabag using page add <url> --tags="tech research" --archive
• Paginate through many unread entries with entry list --status=unread --limit=10 --offset=10