{"id":13661845,"url":"https://github.com/blindFS/vim-taskwarrior","last_synced_at":"2025-04-25T03:31:34.203Z","repository":{"id":10375439,"uuid":"12519893","full_name":"blindFS/vim-taskwarrior","owner":"blindFS","description":"vim interface for taskwarrior","archived":false,"fork":false,"pushed_at":"2019-05-22T12:13:52.000Z","size":367,"stargazers_count":522,"open_issues_count":42,"forks_count":39,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-04-21T15:00:04.690Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"VimL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/blindFS.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}},"created_at":"2013-09-01T11:54:04.000Z","updated_at":"2025-03-10T19:40:56.000Z","dependencies_parsed_at":"2022-08-07T05:15:44.285Z","dependency_job_id":null,"html_url":"https://github.com/blindFS/vim-taskwarrior","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blindFS%2Fvim-taskwarrior","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blindFS%2Fvim-taskwarrior/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blindFS%2Fvim-taskwarrior/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blindFS%2Fvim-taskwarrior/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blindFS","download_url":"https://codeload.github.com/blindFS/vim-taskwarrior/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250747837,"owners_count":21480728,"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":[],"created_at":"2024-08-02T05:01:42.752Z","updated_at":"2025-04-25T03:31:33.850Z","avatar_url":"https://github.com/blindFS.png","language":"VimL","funding_links":[],"categories":["VimL"],"sub_categories":[],"readme":"vim-taskwarrior\n===============\n\n_a vim interface for [taskwarrior](https://taskwarrior.org)_\n\nTaskwarrior is a command-line todo list manager. It helps you manage task lists\nwith projects, tags, dates, dependencies, annotations, recurrences and apply\ncomplex (or simple) queries with attribute modifiers, boolean, regex filters\nand produce any number of reports, built-in or customizable reports, attributes\nand color themes. Task keeps data in JSON text files and it's always improving.\nFind out more at https://taskwarrior.org and read man task and man taskrc.\n\nvim-taskwarrior is a vim plugin that extends taskwarrior with an interactive\ninterface. It features a rich set of mappings and commands, is easy to customize,\nand makes adding, modifying, sorting, reporting and marking done, fast, easy and fun!\nHomepage: https://github.com/farseer90718/vim-taskwarrior, patches welcome!\n\n----\n\n### Prerequisites:\n\nThis plugin requires Taskwarrior 2.2.0 or higher, although \u003e2.3.x is required\nfor taskd sync functions, and recommended in general, and well worth the price;\nfree :)\nsee: https://taskwarrior.org/download/\n\nVim version 7.x is required.\n\nSuggested plugins\n\n* [vim-airline](https://github.com/bling/vim-airline) for [better statusline information](https://github.com/farseer90718/vim-taskwarrior#screenshot).\n* [unite.vim](https://github.com/Shougo/unite.vim) for easier bookmark/history operations.\n\nIf you experience line-wrapping issues, add the following line to your .vimrc\n\n```\nlet g:task_rc_override = 'rc.defaultwidth=0'\n```\n\nIf you experience task truncation (vim-taskwarrior not showing enough tasks), add:\n\n```\nlet g:task_rc_override = 'rc.defaultheight=0'\n```\n\n\n----\n\n### Screenshot:\n\n![screenshot](https://raw.github.com/farseer90718/vim-taskwarrior/master/screenshot.png)\n![vim-taskwarrior animated gif](http://taskextras.org/attachments/download/655/20131110_002753.gif)\n\n### Installing:\n\nEither [download zip file](https://github.com/farseer90718/vim-taskwarrior/archive/master.zip)\nand extract in ~/.vim or use your favorite plugin manager.\n\n- [Pathogen](https://github.com/tpope/vim-pathogen)\n    - `git clone https://github.com/farseer90718/vim-taskwarrior ~/.vim/bundle/vim-taskwarrior`\n- [Vundle](https://github.com/gmarik/vundle)\n    1. Add `Bundle 'farseer90718/vim-taskwarrior'` to .vimrc\n    2. Run `:BundleInstall`\n- [NeoBundle](https://github.com/Shougo/neobundle.vim)\n    1. Add `NeoBundle 'farseer90718/vim-taskwarrior'` to .vimrc\n    2. Run `:NeoBundleInstall`\n- [vim-plug](https://github.com/junegunn/vim-plug)\n    1. Add `Plug 'blindFS/vim-taskwarrior'` to .vimrc\n    2. Run `:PlugInstall`\n\n----\n\n### Default map:\n\n```vim\nnnoremap \u003cbuffer\u003e A       ... \" add annotation\nnnoremap \u003cbuffer\u003e x       ... \" delete annotation.\nnnoremap \u003cbuffer\u003e o       ... \" open the annotation as a file.\nnnoremap \u003cbuffer\u003e a       ... \" create new task.\nnnoremap \u003cbuffer\u003e d       ... \" set the task in current line done.\nnnoremap \u003cbuffer\u003e D       ... \" delete task\nnnoremap \u003cbuffer\u003e \u003cDel\u003e   ... \" delete field/annotation/task\nnnoremap \u003cbuffer\u003e \u003cSpace\u003e ... \" select/remove current task to selected list\nnnoremap \u003cbuffer\u003e m       ... \" modify current field.\nnnoremap \u003cbuffer\u003e M       ... \" modify current task.\nnnoremap \u003cbuffer\u003e f       ... \" change filter\nnnoremap \u003cbuffer\u003e r       ... \" change report type\nnnoremap \u003cbuffer\u003e c       ... \" execute a command for selected tasks/current task\nnnoremap \u003cbuffer\u003e R       ... \" refresh the report/clear selected list\nnnoremap \u003cbuffer\u003e q       ... \" quit buffer.\nnnoremap \u003cbuffer\u003e X       ... \" clear all completed task.\nnnoremap \u003cbuffer\u003e p       ... \" duplicate selected tasks\nnnoremap \u003cbuffer\u003e u       ... \" undo last change.\nnnoremap \u003cbuffer\u003e +       ... \" start task\nnnoremap \u003cbuffer\u003e -       ... \" stop task\nnnoremap \u003cbuffer\u003e S       ... \" sync with taskd server.\nnnoremap \u003cbuffer\u003e s       ... \" sort by this column primarily.(if already of the highest priority then switch the polarity)\nnnoremap \u003cbuffer\u003e \u003c       ... \" sort by this column increasingly.(if already increasingly then increase its priority)\nnnoremap \u003cbuffer\u003e \u003e       ... \" sort by this column decreasingly.(if already decreasingly then decrease its priority)\nnnoremap \u003cbuffer\u003e H       ... \" cycle column format left\nnnoremap \u003cbuffer\u003e L       ... \" cycle column format right\nnnoremap \u003cbuffer\u003e J       ... \" next historical entry\nnnoremap \u003cbuffer\u003e K       ... \" previous historical entry\nnnoremap \u003cbuffer\u003e B       ... \" create a bookmark for current combination\nnnoremap \u003cbuffer\u003e \u003cF1\u003e    ... \" view the documents\nnnoremap \u003cbuffer\u003e \u003cCR\u003e    ... \" show task info.\nnnoremap \u003cbuffer\u003e \u003cTAB\u003e   ... \" jump to the next column\nnnoremap \u003cbuffer\u003e \u003cS-TAB\u003e ... \" jump to the previous column\nnnoremap \u003cbuffer\u003e \u003cright\u003e ... \" jump to the next non-empty column\nnnoremap \u003cbuffer\u003e \u003cleft\u003e  ... \" jump to the previous non-empty column\nvnoremap \u003cbuffer\u003e d       ... \" set done to all visual selected tasks\nvnoremap \u003cbuffer\u003e D       ... \" delete all visual selected tasks\nvnoremap \u003cbuffer\u003e \u003cCR\u003e    ... \" show information about visual selected tasks\nvnoremap \u003cbuffer\u003e \u003cSpace\u003e ... \" add visual selected tasks to selected list\n\n```\n----\n\n### Commands:\n\n```vim\n:TW [args]            \" task [filter report arguments]\n:TWUndo               \" undo the previous modification\n:TWEditTaskrc         \" edit ~/.taskrc\n:TWEditVitrc          \" edit ~/.vitrc\n:TWDeleteCompleted    \" clear all completed tasks\n:TWAdd                \" add new tasks interactively\n:TWAnnotate           \" add an annotation\n:TWComplete           \" mark task done\n:TWDelete             \" deleta a task\n:TWDeleteAnnotation   \" delete an annotation\n:TWModifyInteractive  \" make changes to a task interactively (use with caution!)\n:TWReportInfo         \" run the info report\n:TWReportSort [args]  \" overide the sort method, reset to default if no arguments passed\n:TWSync               \" synchronise with taskd server\n:TWToggleReadonly     \" toggle readonly option\n:TWToggleHLField      \" toggle highlight field option\n:TWHistory            \" list history records using unite.vim\n:TWHistoryClear       \" clear history\n:TWBookmark           \" list bookmarks using unite.vim\n:TWBookmarkClear      \" clear bookmarks\n\n```\n----\n\n### Options:\n\n```vim\n\" default task report type\nlet g:task_report_name     = 'next'\n\" custom reports have to be listed explicitly to make them available\nlet g:task_report_command  = []\n\" whether the field under the cursor is highlighted\nlet g:task_highlight_field = 1\n\" can not make change to task data when set to 1\nlet g:task_readonly        = 0\n\" vim built-in term for task undo in gvim\nlet g:task_gui_term        = 1\n\" allows user to override task configurations. Seperated by space. Defaults to ''\nlet g:task_rc_override     = 'rc.defaultwidth=999'\n\" default fields to ask when adding a new task\nlet g:task_default_prompt  = ['due', 'description']\n\" whether the info window is splited vertically\nlet g:task_info_vsplit     = 0\n\" info window size\nlet g:task_info_size       = 15\n\" info window position\nlet g:task_info_position   = 'belowright'\n\" directory to store log files defaults to taskwarrior data.location\nlet g:task_log_directory   = '~/.task'\n\" max number of historical entries\nlet g:task_log_max         = '20'\n\" forward arrow shown on statusline\nlet g:task_left_arrow      = ' \u003c\u003c'\n\" backward arrow ...\nlet g:task_left_arrow      = '\u003e\u003e '\n\n```\n----\n\n### Syntax highlightling:\n\nDefault scheme:\n\n```vim\nhighlight default link taskwarrior_tablehead   Tabline\nhighlight default link taskwarrior_field       IncSearch\nhighlight default link taskwarrior_selected    Visual\nhighlight default link taskwarrior_id          VarId\nhighlight default link taskwarrior_project     String\nhighlight default link taskwarrior_Status      Include\nhighlight default link taskwarrior_priority    Class\nhighlight default link taskwarrior_due         Todo\nhighlight default link taskwarrior_end         Keyword\nhighlight default link taskwarrior_description Normal\nhighlight default link taskwarrior_entry       Special\nhighlight default link taskwarrior_depends     Todo\nhighlight default link taskwarrior_tags        Keyword\nhighlight default link taskwarrior_uuid        VarId\nhighlight default link taskwarrior_urgency     Todo\n```\n\nFeel free to change any of above by something like:\n\n```vim\nhi taskwarrior_xxx  guibg = xxx guifg = xxx ctermbg = xxx ctermfg = xxx\n```\n\nin your vimrc.\n\n### Acknowledgement:\n\n* [vim-airline](https://github.com/bling/vim-airline) by bling\n* [unite.vim](https://github.com/Shougo/unite.vim)   by Shougo\n* [webapi-vim](https://github.com/mattn/webapi-vim)  by mattn\n\n### License:\n\n[MIT](https://raw.github.com/farseer90718/vim-taskwarrior/master/LICENSE.txt)\n\n\n[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/farseer90718/vim-taskwarrior/trend.png)](https://bitdeli.com/free \"Bitdeli Badge\")\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FblindFS%2Fvim-taskwarrior","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FblindFS%2Fvim-taskwarrior","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FblindFS%2Fvim-taskwarrior/lists"}