Obsidian Pieces Save

Pieces' powerful extension for Obsidian-MD that allows users to access their code snippets directly within the Obsidian workspace

Project README

Pieces for Developers | Obsidian Plugin

This plugin is closed source. The Obsidian team has full access to our private codebase.

In 2022, our team embarked on a mission to transform the way you code with your personal micro-repo.

With the debut release of our Flagship Desktop App, we laid the foundation, and now our Obsidian plugin is here to revolutionize your coding workflow further by incorporating key capabilities and our users' favorite features directly into their Obsidian environment.

Pieces For Developers Banner

Pieces Copilot for Obsidian is here to elevate your coding and problem-solving experience. Interact with the Copilot directly in any Obsidian workspace. Ask questions about code or content within a file, gain insights on patterns or keywords in code snippets, request the Copilot to generate samples using an SDK you're exploring, and even use it to navigate through PRs.

As you progress through your workflow, the Pieces for Developers Obsidian plugin enables you to capture, manage, share, and discover code snippets and other developer materials, like code screenshots, with simple clicks.

Designed to be your ultimate development companion, the Pieces Obsidian plugin transforms your workflow, bringing unparalleled efficiency and organization to your coding experience.

Table of Contents

Recent Updates

v1.8.0 - Persistent Copilot Chats

Nov. 1, 2023

  • Adds persistent copilot conversations, you can not come back to a copilot chat at any time after you leave it
  • Overhauls the context selector to be much simpler and easier to use
  • Context is also persisted per conversation, so each conversation will maintain its context indefinitely
  • Snippets can now be used as context

v1.5.3 - Improved Pieces Copilot Experience

Oct. 3, 2023

  • New Quick Actions feature for easily selecting LLM runtime and file context in a Copilot conversation.
  • Theme Matching to align Copilot's appearance with your environment's theme.
  • Styling updates including new icons for an enhanced user experience.

v1.3.0 - Filter Your Snippet List

Sept. 8, 2023

  • Snippet list filtering based on tags, titles, language, etc., similar to the feature in Pieces Desktop App.
  • Easy access to filtering options via a filter button and a user-friendly interface for setting up filters.
  • Efficient narrowing down of snippet shortlist to find relevant snippets swiftly.

View all updates

Getting Started

Requirements

You must have Pieces OS installed.

Pieces OS facilitates the local operation of Pieces products on your machine and coordinates connections to Pieces extensions. The extension will not function as intended without Pieces OS active on your machine.

*Pieces OS installation comes with the Pieces for Developers Desktop App where your snippets can also be viewed and managed.

Install Instructions

  1. Visit the Pieces for Developers Obsidian Plugin install page.
  2. Click the Install button and then Enable to activate the plugin.

Features

Meet Your New Copilot

Your personal copilot, powered by local or cloud-based LLMs (i.e. Llama 2, GPT-3.5, GPT-4, and PaLM 2) for maximum security and privacy, that’s contextualized by your workflow to help solve coding problems, onboard into new projects faster, and connect you with the right people.

Pieces Copilot

Save useful code to your Pieces micro-repo

Templates, terminal commands, useful snippets, notes...save elements of your notes in one-click to reference or re-use later.

Save with Right Click

Find and re-use just the right snippet when you need it

Blazing fast, powerful search of your code snippets right inside Obsidian.

Manage your Snippets

Share code from Obsidian without breaking your flow

Share snippets with a simple right-click action from within Obsidian. The link ships with both the snippet and its related context - tags, descriptions, where it’s from and more!

Share your Snippets

Thoughtfully designed by fellow developers

  • Runs locally on your machine with the option to connect to the Cloud for backup, sync and sharing
  • Deeply embedded into Obsidian - save, search, and share your snippets entirely from the Pieces for Developers Obsidian Plugin
  • Keyboard shortcuts-enabled

Save with Button

Discover New Snippets

Automatically discovers new highly relevant and reusable snippets from your vault for you to save.

Snippet Discovery

Enrich your code blocks

  • Automatically generate tags, titles, descriptions, and links to other similar code snippets with the simple press of a button!
  • Just click on the 'P' button embedded in your code blocks, and click on the enrich icon!

Keyboard Shortcuts

To use a Pieces command, simply highlight code in your editor or hover a snippet in your Pieces List.

Hotkeys aren't set by default, but here are our recommended layouts.

Command macOS Windows
Save a snippet CMD+Shift+P Ctrl+Shift+P
Share a snippet CMD+Shift+L CMD+Shift+L

Explore the Pieces Ecosystem

Explore our suite of products designed to streamline your coding workflow across different platforms.

Pieces Product Suite

For detailed descriptions and features of our Obsidian plugin, visit our docs for Obsidian.

Need Help?

Encountered a hurdle? We've got you covered. Reach out for support:

Stay Connected

Stay in the loop! Follow us for the latest updates, tips, and insights:

Obsidian Community Disclosure

Please note that this repository is hosting a closed-source Obsidian plugin. While the source code is not publicly available, we assure you that the utmost care has been taken to ensure its quality, performance, and respect for user privacy and data security.

The Pieces For Developers Obsidian Plugin is intended to enhance the functionality and user experience of the Obsidian application, while adhering strictly to the developer policies of Obsidian, notably:

  • We do not obfuscate our code to hide its purpose.
  • We do not insert dynamic ads or static ads outside the Pieces For Developers Obsidian Plugin interface.
  • We do not include client-side telemetry.
  • We temporarily leverage ChatGPT API endpoints.
  • We respect Obsidian's trademark policy.
  • For any issues, feature requests, or policy violations, please feel free to open an issue in this repository. In the case of severe issues or policy violations, please also contact the Obsidian team.

Pieces Privacy Policy

To ensure the continued functionality and reliability of the Pieces For Developers Obsidian Plugin, we commit to providing updates and addressing any issues in a timely manner.

Please refer to the included LICENSE file for details on the terms of use for our plugin.

Thank you for your understanding, and we hope you enjoy using the Pieces For Developers Obsidian Plugin.

Open Source Agenda is not affiliated with "Obsidian Pieces" Project. README Source: pieces-app/obsidian-pieces
Stars
121
Open Issues
3
Last Commit
3 weeks ago
License
MIT

Open Source Agenda Badge

Open Source Agenda Rating