{"id":15387355,"url":"https://github.com/rhysd/vim-notes-cli","last_synced_at":"2025-04-15T18:31:09.800Z","repository":{"id":66059707,"uuid":"156625101","full_name":"rhysd/vim-notes-cli","owner":"rhysd","description":"Vim plugin for notes-cli","archived":false,"fork":false,"pushed_at":"2019-01-07T13:39:02.000Z","size":22,"stargazers_count":19,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-29T00:34:25.668Z","etag":null,"topics":["note-taking","vim","vim-plugin"],"latest_commit_sha":null,"homepage":"https://github.com/rhysd/notes-cli","language":"Vim script","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/rhysd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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":"2018-11-08T00:07:03.000Z","updated_at":"2025-02-06T14:35:28.000Z","dependencies_parsed_at":null,"dependency_job_id":"4842d23a-ed02-46a1-adb5-8cbbcd1b6cd5","html_url":"https://github.com/rhysd/vim-notes-cli","commit_stats":{"total_commits":19,"total_committers":1,"mean_commits":19.0,"dds":0.0,"last_synced_commit":"3c8637babff273dfca28bf39750142df1cd6baaa"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rhysd%2Fvim-notes-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rhysd%2Fvim-notes-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rhysd%2Fvim-notes-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rhysd%2Fvim-notes-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rhysd","download_url":"https://codeload.github.com/rhysd/vim-notes-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249128995,"owners_count":21217264,"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":["note-taking","vim","vim-plugin"],"created_at":"2024-10-01T14:53:42.712Z","updated_at":"2025-04-15T18:31:09.486Z","avatar_url":"https://github.com/rhysd.png","language":"Vim script","funding_links":[],"categories":[],"sub_categories":[],"readme":"Vim + [notes-cli][] for Markdown note taking\n============================================\n\nThis is a Vim plugin to use [notes-cli][] more effectively on Vim (Vim8 or later).\n\n![screencast](https://github.com/rhysd/ss/blob/master/vim-notes-cli/demo.gif?raw=true)\n\n\n\n## Installation\n\nIf you use any package manager, please follow its instruction.\n\nWith [vim-plug](https://github.com/junegunn/vim-plug):\n\n```vim\nPlug 'rhysd/vim-notes-cli'\n```\n\nWith [dein.vim](https://github.com/Shougo/dein.vim):\n\n```vim\ncall dein#add('rhysd/vim-notes-cli', {\n            \\   'lazy' : 1,\n            \\   'on_cmd' : ['Notes', 'NotesSelect', 'NotesNew', 'NotesList', 'NotesGrep'],\n            \\ })\n```\n\nWith [minpac](https://github.com/k-takata/minpac):\n\n```vim\ncall minpac#add('rhysd/vim-notes-cli')\n```\n\nWhen you're using Vim's builtin packager, please follow instruction at `:help pack-add`.\n\nEven if you didn't install [notes-cli][], you don't need to install it. vim-notes-cli automatically\ninstalls `notes` executable and uses it locally.\n\n\n\n## Usage\n\nYou can read manual by `:help vim-notes-cli` after installation.\n\nAll commands can be completed while input. Please input `\u003cTAB\u003e` to complete arguments.\n\n### `:NotesSelect [{args}...]`\n\nIt selects one (or multiple) of candidates with [peco][] or [fzf][] and opens selected notes with new Vim buffers.\nYou can specify a command to select by `g:notes_cli_select_cmd` and how to open buffer by `g:notes_cli_edit_cmd`.\n\nAll arguments are passed to `notes list` command. You can specify category and/or tags by `-c` and/or `-t` options.\n\n**Example:** Only targets 'blog' category and 'Go' tag.\n\n```\n:NotesSelect -c blog -t Go\n```\n\nAnd you can specify the order of list by `-s`.\n\n**Example:** Sort the list with modified date (default is created date)\n\n```\n:NotesSelect -s modified\n```\n\n\n### `:NotesFeelingLucky [{args}...]`\n\nIt is similar to `:NotesSelect`, but does not select one from list. It always select the first candidate like\n`notes list | head -1`.\nThis is useful when you want to open the last created/modified note.\n\n**Example:** Open last-modified note\n\n```\n:NotesFeelingLucky\n```\n\n**Example:** Open last-created note\n\n```\n:NotesFeelingLucky -s created\n```\n\n`{args}` is passed to `notes list` command.\n\n\n### `:NotesNew [{category} [{file}]]`\n\nIt creates new note with specified category and file name. If they are omitted, it asks them interactively\nwith prompt.\n\n**Example:** Create 'how-to-open-file.md' with 'memo' category\n\n```\n:NotesNew memo how-to-open-file\n```\n\n\n### `:NotesGrep [[{args}] /pattern/]`\n\nIt searches notes with `:vimgrep`. `/pattern/` is passed to first argument of `:vimgrep`. If `{args}` is given,\nit is passed to `notes list` to get file paths of notes. By default, `:vimgrep` searches all notes.  Please see\n`:help vimgrep` for details of `:vimgrep` command.\n\nWhen no argument is given, it asks a pattern with propmt.\n\n**Example:** Search 'open file' in all notes\n\n```\n:NotesGrep /open file/\n```\n\n**Example:** Search 'open file' in notes tagged with 'Go'\n\n```\n:NotesGrep -t Go /open file/\n```\n\n\n### `:NotesList [{args}...]`\n\nIt shows list of notes with colors. By default, it outputs the result of `notes --oneline`.\n\n**Example:** Output list of note with one note per line\n\n```\n:NotesList\n```\n\n**Example:** Output full information of each note (path, metadata, title, body)\n\n```\n:NotesList -f\n```\n\nWhen the cursor is on file path, entering `\u003cCR\u003e` opens the note in new buffer.\n\n\n### `:Notes {args}...`\n\nIt runs `notes` command with `{args}`. Command is run with `:terminal`.\n\n**Example:** Show help of `notes` command\n\n```\n:Notes help\n```\n\n**Example:** Update `notes` executable\n\n```\n:Notes selfupdate\n```\n\n\n\n## License\n\n[MIT License](LICENSE.txt)\n\n[notes-cli]: https://github.com/rhysd/notes-cli\n[peco]: https://github.com/peco/peco\n[fzf]: https://github.com/junegunn/fzf\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frhysd%2Fvim-notes-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frhysd%2Fvim-notes-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frhysd%2Fvim-notes-cli/lists"}