{"id":22062129,"url":"https://github.com/pieces-app/plugin_neovim","last_synced_at":"2025-05-12T22:33:41.022Z","repository":{"id":249707748,"uuid":"783734005","full_name":"pieces-app/plugin_neovim","owner":"pieces-app","description":"Pieces for Neovim plugin","archived":false,"fork":false,"pushed_at":"2025-03-19T15:54:13.000Z","size":2073,"stargazers_count":31,"open_issues_count":34,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-01T04:17:45.749Z","etag":null,"topics":["ai","copilot","lua","neovim","neovim-plugin","nvim","nvim-lua","plugin-neovim","snippets"],"latest_commit_sha":null,"homepage":"https://docs.pieces.app/extensions-plugins/neovim","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pieces-app.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-04-08T13:18:25.000Z","updated_at":"2025-03-19T15:43:48.000Z","dependencies_parsed_at":"2024-11-05T12:47:41.428Z","dependency_job_id":"fb2f925c-740f-482d-937a-e4c2ce6e312c","html_url":"https://github.com/pieces-app/plugin_neovim","commit_stats":null,"previous_names":["pieces-app/plugin_neo_vim"],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pieces-app%2Fplugin_neovim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pieces-app%2Fplugin_neovim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pieces-app%2Fplugin_neovim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pieces-app%2Fplugin_neovim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pieces-app","download_url":"https://codeload.github.com/pieces-app/plugin_neovim/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253833241,"owners_count":21971386,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","copilot","lua","neovim","neovim-plugin","nvim","nvim-lua","plugin-neovim","snippets"],"created_at":"2024-11-30T18:17:19.774Z","updated_at":"2025-05-12T22:33:40.999Z","avatar_url":"https://github.com/pieces-app.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# [Pieces for Developers](https://pieces.app) | Neovim Plugin\r\n\r\n# Important\r\n\r\nPlease make sure you have [**Pieces OS**](https://docs.pieces.app/products/meet-pieces) installed to run the Package.\r\n\r\n## Getting Started with the Pieces Neovim Plugin\r\n\r\nWelcome to the **Pieces Neovim Plugin**!\r\n\r\nNeovim Plugin offers extensive functionality to interact with Pieces OS.\r\n\r\n## Installation\r\n\r\n### Using vim-plug\r\n\r\n1. Add the following lines to your `init.vim` or `init.lua`:\r\n\r\n```vim\r\n\" init.vim\r\ncall plug#begin('~/.vim/plugged')\r\n\r\nPlug 'kyazdani42/nvim-web-devicons'\r\nPlug 'MunifTanjim/nui.nvim'\r\nPlug 'hrsh7th/nvim-cmp'\r\nPlug 'pieces-app/plugin_neovim'\r\n\r\ncall plug#end()\r\n```\r\n\r\nInstall the plugins by running `:PlugInstall` in Neovim.\r\n\r\n### Using packer.nvim\r\n\r\n1. Add the following lines to your `init.lua`:\r\n\r\n```lua\r\n-- init.lua\r\nvim.cmd [[packadd packer.nvim]]\r\n\r\nreturn require('packer').startup(function()\r\n  use 'kyazdani42/nvim-web-devicons'\r\n  use 'MunifTanjim/nui.nvim'\r\n  use 'hrsh7th/nvim-cmp'\r\n  use 'pieces-app/plugin_neo_vim'\r\nend)\r\n```\r\nInstall the plugins by running `:PackerSync` in Neovim.\r\n\r\n\r\n\r\n2. download python and pynvim (`pip install pynvim`)\r\n\r\n3. Run :UpdateRemotePlugins\r\n\r\n\r\n## Commands\r\n\r\nThe Pieces Neovim plugin provides several commands to interact with Pieces OS. Here's a list of available commands:\r\n\r\n## General Commands\r\n\r\n### `:PiecesHealth`\r\n\r\nCheck the health of Pieces OS.\r\n\r\n```vim\r\n:PiecesHealth\r\n```\r\n\r\n### `:PiecesOSVersion`\r\n\r\nDisplay the version of Pieces OS.\r\n\r\n```vim\r\n:PiecesOSVersion\r\n```\r\n### `:PiecesPluginVersion`\r\n\r\nDisplay the current version of the Pieces Neovim plugin.\r\n\r\n```vim\r\n:PiecesPluginVersion\r\n```\r\n\r\n## Copilot Commands \r\n\r\n### `:PiecesCopilot`\r\n\r\nOpen the Pieces Copilot window in a split view. \r\n\r\n```vim\r\n:PiecesCopilot\r\n```\r\n\r\n#### Using the Copilot Chat\r\n\r\n1. Press `i` to enter insert mode and type your message.\r\n2. Press `\u003cEsc\u003e` to exit insert mode.\r\n3. Press `\u003cEnter\u003e` to send the message to Pieces Copilot and see the response.\r\n\r\n#### Copilot Chat Commands\r\n\r\nIn the Copilot chat input, you can use slash commands to perform specific actions:\r\n\r\n####  `/change_model`\r\n\r\nChange the current LLM model.\r\n\r\n### `:PiecesChats`\r\n\r\nOpen a list of Pieces Copilot conversations to choose from.\r\n\r\n```vim\r\n:PiecesChats\r\n```\r\nNavigation and actions:\r\n- Press `\u003cDel\u003e` on the selected conversation to delete it\r\n- Use `\u003cUp\u003e` and `\u003cDown\u003e` arrow keys to navigate the conversation list\r\n- Press `\u003cEnter\u003e` to open the selected conversation in the Copilot\r\n\r\n## Asset Management Commands\r\n\r\n### `:PiecesDrive`\r\n\r\nList all of the saved materials.\r\n\r\n```vim\r\n:PiecesDrive\r\n```\r\nNavigation and actions:\r\n- Use `\u003cUp\u003e` and `\u003cDown\u003e` arrow keys to navigate the material list.\r\n- Press `\u003cEnter\u003e` to open the selected material for editing.\r\n- Press `\u003cDel\u003e` on the selected material to delete it.\r\n- When editing a material:\r\n  1. Press `i` to enter insert mode and make changes.\r\n  2. Press `\u003cEsc\u003e` to exit insert mode.\r\n  3. Type `:w` and press `\u003cEnter\u003e` to save the edited material.\r\n  4. Type `:q` and press `\u003cEnter\u003e` to exit the material editor.\r\n\r\n\r\n### `:PiecesCreateMaterial`\r\n\r\nCreate a material from the selected text in the visual mode.\r\n\r\n```vim\r\n:PiecesCreateMaterial\r\n```\r\n\r\n1. Enter visual mode by pressing `v` in normal mode.\r\n2. Select the desired text using arrow keys or Vim motions.\r\n3. Type `:PiecesCreateMaterial` and press `\u003cEnter\u003e`.\r\n\r\n## Auth Commands\r\n\r\n### `:PiecesAccount`\r\n\r\nShows your Pieces account information such as Username, Email, Personal Cloud Status and Personal Domain in a new window.  \r\n\r\n```vim\r\n:PiecesAccount\r\n```\r\nYou can also logout from your account by going to the `Logout` option in the Auth status menu and then press `enter`. You will be logged out of your Pieces account.\r\n\r\n### `:PiecesLogin`\r\n\r\nLogin to your Pieces account.\r\n\r\n```vim\r\n:PiecesLogin\r\n```\r\n\r\n### `:PiecesLogout`\r\n\r\nLogout of your Pieces account.\r\n\r\n```vim\r\n:PiecesLogout\r\n```\r\n\r\n### `:PiecesConnectCloud`\r\n\r\nConnect to your Personal Pieces Cloud. \r\n\r\n```vim\r\n:PiecesConnectCloud\r\n```\r\n\r\n### `:PiecesDisconnectCloud`\r\n\r\nDisconnect from your Personal Pieces Cloud.\r\n\r\n```vim\r\n:PiecesDisconnectCloud\r\n```\r\n Note: In order to use the Personal Pieces Cloud commands, you must have an account connected to Pieces OS.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpieces-app%2Fplugin_neovim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpieces-app%2Fplugin_neovim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpieces-app%2Fplugin_neovim/lists"}