Add pieces-raycast extension (raycast#13626)

* Add pieces-raycast extension

- chore: add gifs to metadata folder
- feat: add images to the readme
- chore: add section to install pieces os
- Merge pull request #36 from pieces-app/fix/search-command
- fix: check for deleted indicie
- chore: verison bump
- Merge pull request #35 from pieces-app/fix/search-command
- fix: issue in search command
- Merge pull request #34 from pieces-app/fix/undefined-error
- fix: async race condition
- Merge pull request #30 from pieces-app/update-testing-readme
- chore: more release prep
- chore: change author
- chore: extension icon
- Update README_DEVELOPMENT.md
- Merge pull request #29 from pieces-app/chore/readme
- chore: adjust developer readme
- chore: adjust package.json
- chore: switch app to raycast
- chore: update readme
- Merge pull request #2 from pieces-app/feat/init
- chore: add comments
- chore: add annotations
- feat: searching snippets
- feat: add asset fetching code
- feat: hook up preferences
- feat: add preferences
- feat: add health check to react commands feat: update browser history UI
- chore: add health check to no-view commands
- feat: working automatically updating
- feat: auto update
- feat: install check
- chore: refactor clipboard + browser history
- feat: save browser history to pieces
- fix: rendering directories
- fix: importing errors
- feat: add code back in
- Merge pull request #1 from pieces-app/chore/wipe
- chore: wipe code
- feat: first commit

* Update pieces-raycast extension

- chore: adjust extension title
- chore: fix image dimensions
- chore: formatting fix

* Update CHANGELOG.md

* Update pieces-raycast extension

- Merge branch \'contributions/merge-1722267309615891000\'
- Pull contributions
- Merge pull request #39 from pieces-app/fix/review-feedback
- fix: use raycast open
- chore: adjust feedback for review
- Merge pull request #38 from pieces-app/chore/unit-testing
- chore: remove log
- feat: add tests
- feat: add tests
- chore: add test
- feat: add fetch asset unit test

* Update pieces-raycast extension

- feat: add toast notifications for raycast api operations
- fix: don\'t prompt for install if the apple script stderr

* Update CHANGELOG.md and optimise images

---------

Co-authored-by: Milena Araujo <mil3na@users.noreply.github.com>
Co-authored-by: raycastbot <bot@raycast.com>

extensions/pieces-raycast/.eslintrc.json

@@ -0,0 +1,4 @@
+{
+  "root": true,
+  "extends": ["@raycast"]
+}

extensions/pieces-raycast/.gitignore

@@ -0,0 +1,13 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+
+# Raycast specific files
+raycast-env.d.ts
+.raycast-swift-build
+.swiftpm
+compiled_raycast_swift
+
+# misc
+.DS_Store

extensions/pieces-raycast/.prettierrc

@@ -0,0 +1,5 @@
+{
+  "printWidth": 80,
+  "singleQuote": false,
+  "semi": true
+}

extensions/pieces-raycast/CHANGELOG.md

@@ -0,0 +1,12 @@
+# pieces-raycast Changelog
+
+## [Initial Version] - 2024-08-08
+
+- "Save Browser History to Pieces" command that will show a list of code blocks that are present in your browser, enriched with useful metadata. Simply highlight a code block and hit 'return' to save it to Pieces
+- "Save Clipboard History to Pieces", similarly to browser history, it will show your recent clipboard items enriched by Pieces, giving you quick and easy access to save them.
+- "Save Text Selection in Frontmost Application to Pieces" will save the text selection in the frontmost application to Pieces.
+- "Save Finder Selection to Pieces" will save the files that are selected in Finder to Pieces. Note: this command will only work if Finder is the frontmost application.
+- "Save Clipboard to Pieces" will save your current clipboard to Pieces.
+- "Sign into Pieces" will open the Pieces OAUTH panel for you to sign in.
+- "Signout of Pieces" will log you out of Pieces.
+- "Search Saved Pieces" will open a search dialog for your snippets, allowing you to easily copy one.

extensions/pieces-raycast/README.md

@@ -0,0 +1,105 @@
+# Pieces for Developers ⎸ Raycast Extension
+
+## Overview
+
+Welcome to the Pieces for Developers Raycast Extension! This extension brings powerful features to your fingertips, allowing you to streamline your workflow and boost productivity.
+
+In order to use the Pieces Raycast Extension, you must have <a target="blank" href="https://docs.pieces.app/installation-getting-started/what-am-i-installing">Pieces OS.</a> We recommend also using the Pieces for Developers desktop app.
+
+Pieces for Developers is an AI powered productivity tool tailored for developers. We have many features that horizontally integrate across the developer toolchain including a streamlined snippet-saving experience that helps you organize your reusable code while automatically augmenting it with useful metadata, as well as our Copilot which is an AI chat that is highly tailored to your specific context as a developer. Here’s a breakdown of the features available in this extension:
+
+## Features
+
+### Search Saved Pieces
+
+![Search Snippets](media/search%20snippets.gif)
+
+Quickly search through your saved pieces to find and reuse exactly what you need.
+
+- **Command:** `Search Saved Snippets`
+
+### Save Clipboard History to Pieces
+
+![Clipboard History](media/save%20clipboard%20history.gif)
+
+View a list of your clipboard history, enriched with useful metadata like related links, tags, and titles. Select one of the items to save it to Pieces.
+
+- **Command:** `Save Clipboard History to Pieces`
+
+### Save Browser History to Pieces
+
+![Browser History](media/save-browser-history.gif)
+
+View a list of the code snippets discovered in your recent browsing history. Each code snippet is enriched with useful metadata. Select an item to save it to Pieces.
+
+- **Command:** `Save Browser History to Pieces`
+
+### Save Clipboard to Pieces
+
+![Save Clipboard to Pieces](media/save%20clipboard.gif)
+
+Save the current clipboard content to Pieces with a single command.
+
+- **Command:** `Save Clipboard to Pieces`
+
+### Save Finder Selection to Pieces
+
+![Save Finder Selection to Pieces](media/save%20finder%20selection.gif)
+
+Select files in Finder and save them directly to Pieces, keeping your important resources organized.
+
+- **Command:** `Save Finder Selection to Pieces`
+
+### Save Text Selection in Frontmost Application to Pieces
+
+![Save Frontmost Selection](media/save%20frontmost%20selection.gif)
+
+Highlight text in any application and save it to Pieces for easy reference and reuse.
+
+- **Command:** `Save Selection in Frontmost Application to Pieces`
+
+### Login to Pieces
+
+![Login](media/sign%20in%20to%20pieces.gif)
+
+Securely log in to your Pieces account directly from Raycast.
+
+- **Command:** `Sign into Pieces`
+
+### Logout of Pieces
+
+![Logout](media/signout.gif)
+
+Easily log out of your Pieces account.
+
+- **Command:** `Signout of Pieces`
+
+## External Resources
+
+- [Pieces for Developers](https://pieces.app/)
+- [Visual Studio Code Extension](https://marketplace.visualstudio.com/items?itemName=MeshIntelligentTechnologiesInc.pieces-vscode)
+- [Release Notes & Monthly Newsletter](https://code.pieces.app/updates)
+- [Blog of Technical Content & Tutorials](https://code.pieces.app/blog)
+
+## Social Media and Support
+
+- [Twitter](https://twitter.com/getpieces)
+- [LinkedIn](https://www.linkedin.com/company/getpieces/)
+- Email: [support@pieces.app](mailto:support@pieces.app)
+
+## Community and Feedback
+
+Join our community and help shape the future of Pieces for Developers. Your feedback is invaluable to us, and we welcome any suggestions or feature requests.
+
+### Join the Community
+
+- [Join our Discord community](https://discord.gg/getpieces)
+- [Submit Feedback](https://getpieces.typeform.com/to/mCjBSIjF?os=9a9bc924-80cf-4f66-b7e8-da6526e0a5d0&user=85d3a788-9617-4a31-862b-bc26c649acca)
+- [Join our Beta Program](https://getpieces.typeform.com/to/XGGlUqEI?os=9a9bc924-80cf-4f66-b7e8-da6526e0a5d0&user=85d3a788-9617-4a31-862b-bc26c649acca)
+- [Get Updates](https://code.pieces.app/updates)
+- [Subscribe to our YouTube Channel](https://www.youtube.com/@getpieces)
+- [Engage with us on Twitter & LinkedIn](https://twitter.com/getpieces)
+
+### Troubleshooting and Support
+
+- [Get 1:1 Support](https://docs.pieces.app/support)

extensions/pieces-raycast/README_DEVELOPMENT.md

@@ -0,0 +1,17 @@
+# Developer Readme
+
+### Installing local extension
+
+1. clone this repository
+2. checkout the version you would like to use (the main branch, or a specific tag)
+3. open the cloned repository in a terminal and run `npm i && npm run build`
+4. open raycast
+5. search `import extension`
+6. run the `import extension` command
+7. select the cloned repository
+8. Now run `npm run dev` command in the cloned repository
+9. have fun!
+
+### Lifecycle of a Command
+
+It's very important to await any asynchronous operation within a command. Without doing this, the command will be disposed without completing.