{"id":28739295,"url":"https://github.com/psaia/prompt-ai.vim","last_synced_at":"2025-09-11T16:22:23.104Z","repository":{"id":297840295,"uuid":"998038039","full_name":"psaia/prompt-ai.vim","owner":"psaia","description":"qc-ai - Quickly configure you vim runtime with natural language.","archived":false,"fork":false,"pushed_at":"2025-06-09T00:29:21.000Z","size":8150,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-09T01:26:31.666Z","etag":null,"topics":["ai","neovim","openai","vim"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/psaia.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2025-06-07T18:26:23.000Z","updated_at":"2025-06-09T00:29:10.000Z","dependencies_parsed_at":"2025-06-09T01:37:14.884Z","dependency_job_id":null,"html_url":"https://github.com/psaia/prompt-ai.vim","commit_stats":null,"previous_names":["psaia/qc-ai","psaia/prompt-ai.vim"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/psaia/prompt-ai.vim","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/psaia%2Fprompt-ai.vim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/psaia%2Fprompt-ai.vim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/psaia%2Fprompt-ai.vim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/psaia%2Fprompt-ai.vim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/psaia","download_url":"https://codeload.github.com/psaia/prompt-ai.vim/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/psaia%2Fprompt-ai.vim/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260109457,"owners_count":22960023,"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","neovim","openai","vim"],"created_at":"2025-06-16T06:00:33.483Z","updated_at":"2025-06-16T06:02:37.755Z","avatar_url":"https://github.com/psaia.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ⚡️ prompt-ai - configure vim with natural language\n\n**prompt-ai** is a super lightweight Neovim plugin that lets you configure your editor using natural language prompts like:\n\n* `:P use a light theme and turn on line numbers`\n* `:P optimize for viewing large files`\n* `:P replace word \"foo\" with \"bar\"`\n* `:P use the kanagawa-lotus colorscheme`\n* `:P format file`\n* Or really anything you can think of.\n\n![Demo](./demo.gif)\n\n---\n\n## ✨ Features\n\n* Easily apply prompt config via natural language (`:P`)\n* Caches responses to avoid redundant API calls\n* Remembers previous conversations (limited to recent history)\n* Saves history and cache to disk across sessions\n* Configurable model, temperature, and history length\n* Commands to clear history and cache\n\n\n\u003e [!TIP]\n\u003e This plugin focuses solely on one thing: on-the-fly Vim prompt generation.\n\u003e If you're looking for AI-powered file editing or manipulation, check out [vim-ai](https://github.com/madox2/vim-ai). prompt-ai and vim-ai compliment each other well.\n\n---\n\n## 📦 Requirements\n\n* Neovim 0.8+\n* OpenAI API key in your environment:\n\n```sh\nexport OPENAI_API_KEY=\"sk-...\"\n```\n\n## 🚀 Installation (Lazy.nvim)\n\n```lua\n{\n  \"psaia/prompt-ai.vim\",\n  config = function()\n    require(\"prompt_ai\").setup({\n      model = \"o4-mini\",    -- or \"o4-mini\" (default)\n      temperature = 1  ,    -- controls creativity (default: 1)\n      max_history = 8,      -- max prompt/response pairs remembered (default: 8)\n    })\n  end,\n  cmd = { \"P\", \"PClearHistory\", \"PClearCache\" },\n}\n```\n\n---\n\n## Usage\n\n### Configure with Natural Language\n\n```vim\n:P use gruvbox with transparent background\n```\n\n### Clear History\n\n```vim\n:PClearHistory\n```\n\n### Clear Cache\n\n```vim\n:PClearCache\n```\n\n---\n\n## Where Data is Stored\n\n| File                                         | Purpose                 |\n| -------------------------------------------- | ----------------------- |\n| `~/.local/share/nvim/ai_config_history.json` | Prompt/response history |\n| `~/.local/share/nvim/ai_config_cache.json`   | Prompt → code cache     |\n| `/tmp/nvim_ai_config.log`                    | Log file (debug)        |\n\n---\n\n## Privacy \u0026 Safety\n\nNo telemetry or analytics. Your prompts and configs are never stored or sent anywhere beyond OpenAI's API.\n\n---\n\n## Ideas for the Future\n\n* Intelligently contextualize pre-installed plugins for more relevant prompts\n* Different models other than OpenAI\n* Telescope integration for history\n* Floating preview of generated code\n\n---\n\n#### 🖤 Created by [@psaia](https://github.com/psaia)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpsaia%2Fprompt-ai.vim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpsaia%2Fprompt-ai.vim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpsaia%2Fprompt-ai.vim/lists"}