NextIteration.Snipdeck.Importer 1.1.0

snipdeck-importer

A small cross-platform console tool that imports command snippets from other tools into a Snipdeck store. The first supported source is SnipCommand; the design leaves room for more sources as subcommands later.

It is shipped and versioned independently of the desktop app (it is a .NET tool), and targets net10.0, so it builds and runs on Windows, Linux and macOS — handy for bulk-prepping an import on a non-Windows box before opening Snipdeck.

Install

dotnet tool install -g NextIteration.Snipdeck.Importer

The package id is NextIteration.Snipdeck.Importer; the installed command is snipdeck-importer.

Or run it straight from the repo without installing:

dotnet run --project tools/Snipdeck.Importer -- snipcommand <path>

Usage

snipdeck-importer snipcommand <path> [options]

<path> is a SnipCommand export. Despite SnipCommand's .db extension, the export is JSON — point the importer straight at it.

Dry-run first

By default the importer parses the source, prints the planned additions grouped by the CLI each snip would land in, and exits without touching the store:

snipdeck-importer snipcommand snipcommand.db

Add --write once the preview looks right:

snipdeck-importer snipcommand snipcommand.db --write

What it does

• Groups by CLI. SnipCommand stores a flat list; Snipdeck organises snips under a CLI. The CLI is auto-suggested from the first whitespace-delimited token of each command (mpt-app orders list → mpt-app), peeling off launcher wrappers such as sudo / npx. Use --cli to force one CLI for everything, or --into as a fallback for commands the importer couldn't classify confidently.
• Translates parameters. SnipCommand's inline [sc_choice …] and [sc_variable …] markup becomes Snipdeck {token} placeholders plus a structured parameter list (Choice with options, or Text), with a sensible default carried across. Variable names containing spaces or punctuation are slugified into legal token names.
• Shares duplicated parameters. When a parameter recurs across two or more snips in the same CLI, it is promoted to a CLI-scoped shared parameter and removed from the individual snips (which then inherit it by token name). Choice parameters match on their option set (order-independent) — names need not match, the most common name wins, and snips that used a different name have their template token rewritten to it. Text parameters match by name, and the most common default value wins (including an empty default). Single-use parameters stay on their snip. Pass --no-share-parameters to disable.
• Carries metadata. Title, description, tags and favourite flag come across; usage counts and last-used timestamps are preserved when present. Trashed entries are skipped.
• Merges safely. With --write the importer backs the existing store up first (honouring the desktop app's retention policy), mints fresh identifiers, creates any missing CLIs on demand, and skips snips that already exist by (title, command) unless --allow-duplicates is given. The atomic store write means a running desktop instance can't be corrupted — but it won't see the changes until it next reloads, so restart Snipdeck after importing.

Building and testing

dotnet build tools/Snipdeck.Importer
dotnet test  tools/Snipdeck.Importer.Tests