Try out the world's first micro-repo!
Learn More

New Features

Bug Fixes

UX/UI Updates

Pieces 1.8.0: It’s getting pretty wild out here 🤠 Automatic Snippet Descriptions, JSON/YAML/TOML support, Gen 2 Sharing, and a whole lot more 🔥

Today, we’re releasing a seriously upgraded sharing experience, support for JSON, YAML and TOML (a very popular request!), the ability to copy code with its context in the Pieces desktop app and so much more!

1.8.0 marks a huge jump forward in user experience, and we’re continuing to work hard on building the best possible personal micro-repo. Let us know what you think of this release and what we should improve next!

Snippet Sharing, massively improved

We’re super excited to be releasing the latest version of sharing your snippets! The experience for recipients of Pieces links is way better— once recipients click your share link, they can preview the code and view its context without having Pieces installed or running.

The updated shared snippet experience.

From the preview, they can easily save the snippet to Pieces, copy the code, or copy the code and its context with one click.

Our upgraded sharing experience also introduces Related People. Pieces will automatically associate you with your snippets and maintain that association when you share a snippet. Anyone who saves a snippet you share will be able to tell that it came from you!

YAML, JSON and TOML support

We’ve added support for three of our most-suggested languages: YAML, JSON and TOML. They’ll now be automatically classified, formatted and syntax highlighted correctly.

A YAML Snippet, correctly classified in Pieces.

If you’d like Pieces to support a new language, let us know here.

Copy code with context

The Pieces desktop app is one of the most powerful tools in the Pieces Suite because of the metadata associated with every snippet. To copy both the code and its context, hover over the icon in the bottom right corner and hit “Copy with Context Summary” to add it to your clipboard. From there, wherever you paste, you'll paste both the code and its related context.

The option to copy your snippet with its context in the Pieces desktop app.

Auto-generated descriptions

Adding a description to your snippets makes them way more useful— they’re easier to search for, give you implementation information, source information or whatever other info you find helpful. But, it takes time to add a good description. In this release, Pieces will auto-generate Smart Descriptions for all of your snippets! The Smart Descriptions live alongside your manually added descriptions, and you can edit or remove them if you’d like something different.

An auto-generated description in the Pieces desktop app.

Fine-tune your user experience

You can now set preferences for notifications and confirmation messages in the Pieces desktop app. If you prefer, you can choose to limit your notifications to only critical notifications or turn them off entirely. You can also choose to turn off confirmation messages on deletion events.

All of your preferences can be edited in the settings menu of the Pieces desktop app.

Notification settings in Pieces for Developers.

Bug fixes and performance improvements

Finally, this release includes a plethora of bug fixes and performance improvements. Most notably, you’ll be logged out for security far less often than before!

Pieces OS

New Endpoints:


  • Accepts files or strings and returns a list of recommended assets
  • Includes a property, ‘discovered: true’ on an asset returned by the endpoint


  • An endpoint that accepts a tag as a parameter and returns a list of related tags

Infrastructure to support Related People

Bug Fixes & Performance Improvements

  • The format creator is now in sync with an asset creator
  • Faster loading time on boot-up from ~2.5s to ~1.5s


As always, if you run into issues or have feedback, please fill out this quick form or email us at and we’ll be in touch as soon as possible!

Interested in becoming a Pieces Content Partner?

Learn More
Other Updates