What’s New in GoSuki v1.3.0: ArchiveBox Integration and Enhanced Search

I’m excited to share GoSuki v1.3.0, which introduces a new archival workflow through ArchiveBox integration and significantly enhances the CLI search experience. This release delivers precise technical improvements without compromising our lightweight architecture.

ArchiveBox Integration: A New Archival Workflow

GoSuki now supports seamless integration with ArchiveBox—a self-hosted web archiving solution—via our Marktab feature system. This isn’t a native archive implementation (that’s coming later), but a robust temporary workflow using existing tooling:

# Enable in your gosuki marktab
##	#  *  *   *
##	#  |  |   |_____ shell command to execute
##	#  |  |_________ pattern to match on the url or title
##	#  |____________ trigger keyword to detect in tags

@archivebox .* ~/.local/share/gosuki/archivebox-docker-ssh

When you create a bookmark tagged @archivebox or place it in a folder named @archivebox, GoSuki automatically triggers the configured script. The archivebox-docker-ssh script (included in the distribution package) then connects to your ArchiveBox instance—either locally or via SSH/Docker—and adds the URL with appropriate tags.

This workflow leverages GoSuki’s existing hook system while keeping dependencies minimal. It solves a critical pain point for users who need permanent archival without cloud vendor lock-in, and it integrates cleanly with our existing tag-based organization system. Gosuki+ArchiveBox means that the archival process is fully automated and seamless—users need only tag their bookmarks with the @archivebox tag or place them inside a folder with the same name. GoSuki then relays the archiving commands to ArchiveBox and applies any additional tags present on the bookmark. For full implementation details, see the ArchiveBox integration guide.

Enhanced suki CLI Search: Precision Filtering at Your Fingertips

The suki command line tool now offers advanced search capabilities through a redesigned query engine:

# AND filtering (requires both tags)
suki fuzzy "machine learning" :research,ai

# OR filtering (matches either tag)
suki fuzzy "machine learning" :OR research,ai

# Combined query with tags and text
suki search "quantum computing" :papers,notebook :OR ai,physics

Key technical improvements include:

• Full support for logical AND/OR tag combinations in a single query
• Simultaneous filtering by search terms and multiple tags
• Fuzzy matching that respects both text content and tag metadata
• Updated API endpoints (/api/bookmarks) with enhanced filtering parameters

These changes stem from restructuring our internal query processor to handle composite tag filters. The backend now processes :tag1,tag2 as an AND condition and :OR tag1,tag2 as an OR condition—exactly matching the behavior users expect from modern search systems.

Other Technical Improvements

• New export formats: Added support for Pocket HTML, Pinboard/Wallabag JSON, and generic XML-RSS via gosuki export
• Fixed import workflows: Corrected Pocket CSV import format handling (previously failed on certain metadata)
• Browser metadata: Now properly populates the module field in bookmarks to indicate browser source
• Documentation: Added manpages for both gosuki and suki commands

Why These Changes Matter

The ArchiveBox integration specifically addresses a core user need: preserving curated content beyond browser lifecycles. By using a standard tool like ArchiveBox instead of building our own archive system, we maintain GoSuki’s lightweight philosophy while giving users control over their archival infrastructure.

Meanwhile, the search enhancements solve real pain points in large bookmark sets. Previously, filtering by multiple tags required chaining commands or manual post-processing. Now users can execute complex queries directly through the CLI with minimal overhead.

Get Started

Download GoSuki v1.3.0 from GitHub or install via your package manager. The ArchiveBox integration requires separate setup of your ArchiveBox instance and the archivebox-docker-ssh script (see documentation for details).

This release includes a new contributor: @mariusrugan who helped refine the search API implementation.

I’ve been working on these features since v1.2.1, making sure they integrate with our existing architecture without adding dependencies or complexity. The technical precision in both the ArchiveBox workflow and search engine reflects GoSuki’s core philosophy: minimalism with maximum flexibility.