{"id":15580317,"url":"https://github.com/bronzehedwick/vim-primary-terminal","last_synced_at":"2025-07-16T05:05:30.248Z","repository":{"id":56000967,"uuid":"221998350","full_name":"bronzehedwick/vim-primary-terminal","owner":"bronzehedwick","description":"Simple terminal management for neovim","archived":false,"fork":false,"pushed_at":"2022-03-14T17:23:25.000Z","size":29,"stargazers_count":5,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-24T02:03:47.740Z","etag":null,"topics":["neovim","terminal","vim","vim-plugin","vim-plugins"],"latest_commit_sha":null,"homepage":null,"language":"Vim script","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/bronzehedwick.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}},"created_at":"2019-11-15T20:30:05.000Z","updated_at":"2022-08-28T11:26:42.000Z","dependencies_parsed_at":"2022-08-15T11:10:24.805Z","dependency_job_id":null,"html_url":"https://github.com/bronzehedwick/vim-primary-terminal","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/bronzehedwick/vim-primary-terminal","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bronzehedwick%2Fvim-primary-terminal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bronzehedwick%2Fvim-primary-terminal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bronzehedwick%2Fvim-primary-terminal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bronzehedwick%2Fvim-primary-terminal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bronzehedwick","download_url":"https://codeload.github.com/bronzehedwick/vim-primary-terminal/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bronzehedwick%2Fvim-primary-terminal/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265483216,"owners_count":23774168,"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":["neovim","terminal","vim","vim-plugin","vim-plugins"],"created_at":"2024-10-02T19:24:05.537Z","updated_at":"2025-07-16T05:05:30.203Z","avatar_url":"https://github.com/bronzehedwick.png","language":"Vim script","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Primary Terminal\n\nSimple terminal management for Neovim.\n\n## Why another terminal manager?\n\nI wanted something very minimal, that only took control of a single\n`:terminal` instance at a time; this served my use case well.\n\nI prefer the flyweight simplicity of that approach, since 90% of the\ntime I only want to interact with the same terminal instance.\n\nIf I do need another one, it's easy enough to create another un-managed\n`:terminal`, or a process-specific `:e term://my-command`.\n\n## Installation\n\nIf you're using a plugin manager, follow the instructions in their\ndocumentation.\n\nFor example, if you're using\n[Packer](https://github.com/wbthomason/packer.nvim), you would add the\nfollowing to your configuration:\n\n```lua\nuse 'bronzehedwick/vim-primary-terminal'\n```\n\nOtherwise, use [native package\nsupport](https://neovim.io/doc/user/repeat.html#packages)\nby cloning vim-primary-terminal to\n[`packpath`](https://neovim.io/doc/user/options.html#packpath).\n\n```sh\ngit clone https://github.com/bronzehedwick/vim-primary-terminal \\\n    ${XDG_DATA_HOME:-$HOME/.local/share}/nvim/site/pack/plugins/start/vim-primary-terminal\n```\n\n## Commands\n\nvim-primary-terminal provides the following commands:\n\n- `:PrimaryTerminalOpen`: Open the primary terminal in the current window.\n- `:PrimaryTerminalOpenSplit`: Open the primary terminal in a horizontal split window.\n- `:PrimaryTerminalOpenVsplit`: Open the primary terminal in a vertical split window.\n- `:T[!] {args}`: Pass `{args}` to the primary terminal. If `!` is passed, load the primary terminal in the preview window as well.\n- `:Tkill`: Kill the current process running in the primary terminal by sending \u003ckbd\u003eCtrl+c\u003c/kbd\u003e\n\n## Key mappings\n\nvim-primary-terminal provides the following\n[`\u003cPlug\u003e`](https://neovim.io/doc/user/map.html#%3CPlug%3E) mappings:\n\n- `\u003cPlug\u003e(PrimaryTerminalOpen)`: Execute `:PrimaryTerminalOpen`\n- `\u003cPlug\u003e(PrimaryTerminalOpenSplit)`: Execute `:PrimaryTerminalOpenSplit`\n- `\u003cPlug\u003e(PrimaryTerminalOpenVsplit)`: Execute `:PrimaryTerminalOpenVsplit`\n- `\u003cPlug\u003e(PrimaryTerminalOpenDynamic)`: Execute `:PrimaryTerminalOpenDynamic`\n\nUsing `\u003cPlug\u003e` allows you to customize if and what key sequences to map to.\n\nHowever, if you don't have a preference, add the following mappings to\nyour `init.vim`:\n\n```vim\nnmap \u003cunique\u003e \u003csilent\u003e \u003cleader\u003et \u003cPlug\u003e(PrimaryTerminalOpen)\nnmap \u003cunique\u003e \u003csilent\u003e \u003cleader\u003er \u003cPlug\u003e(PrimaryTerminalOpenSplit)\nnmap \u003cunique\u003e \u003csilent\u003e \u003cleader\u003ey \u003cPlug\u003e(PrimaryTerminalOpenVsplit)\nnmap \u003cunique\u003e \u003csilent\u003e \u003cleader\u003ed \u003cPlug\u003e(PrimaryTerminalOpenDynamic)\n```\n\nSee [`:help primary-terminal`](./doc/primary-terminal.txt) for more.\n\n## Similar projects\n\n- [neoterm](https://github.com/kassio/neoterm)\n- [FTerm](https://github.com/numToStr/FTerm.nvim)\n- [terminus](https://github.com/brettanomyces/nvim-terminus)\n- [editcommand](https://github.com/brettanomyces/nvim-editcommand)\n- [nuake](https://github.com/Lenovsky/nuake)\n- [split term](https://github.com/vimlab/split-term.vim)\n\n## License\n\nCopyright © 2019–2022 Chris DeLuca\n\nLicensed under the same terms as Vim itself.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbronzehedwick%2Fvim-primary-terminal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbronzehedwick%2Fvim-primary-terminal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbronzehedwick%2Fvim-primary-terminal/lists"}