here.term

KO | EN

gitlite — search

#python #ai #llm #android #rust #macos #nodejs #java #windows #awesome #cli #pytorch #security #open-source

(★ 76)

Once you've gone through all terminal solutions, you'll end up here

here.term 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# here.term

Use a single terminal instance as any other buffer. Toggle between the file you're editing and the terminal with a single command (`<C-;>`). Kill it just as easily (`<C-S-;>`).

![here-term](https://github.com/user-attachments/assets/f11c1456-e299-4b17-9eb4-b710015b0c52)

## Installation

With [lazy](https://github.com/folke/lazy.nvim):
```lua
{
    "jaimecgomezz/here.term",
    opts = {},
}
```

Please make sure you have set the `hidden` option in your config file or the terminal will be discarded when toggled. 
```lua
vim.opt.hidden = true
```

## Configuration

Here are the default options:
```lua
require("here-term").setup({
    -- The command we run when exiting the terminal and no other buffers are listed. An empty
    -- buffer is shown by default. 
    startup_command = "enew", -- Startify, Dashboard, etc. Make sure it has been loaded before `here.term`.

-- Mappings
    -- Every mapping bellow can be customized by providing your preferred combo, or disabled
    -- entirely by setting them to `nil`.
    --
    -- The minimal mappings used to toggle and kill the terminal. Available in
    -- `normal` and `terminal` mode.
    mappings = {
        enable = true,
        toggle = "<C-;>",
        kill = "<C-S-;>",
    },
    -- Additional mappings that I consider useful since you won't have to escape (<C-\><C-n>)
    -- the terminal each time. Available in `terminal` mode.
    extra_mappings = {
        enable = true, -- Disable them entirely
        escape = "<C-x>", -- Escape terminal mode
        left = "<C-w>h", -- Move to the left window
        down = "<C-w>j", -- Move to the window down
        up = "<C-w>k", -- Move to the window up
        right = "<C-w>l", -- Move to right window
    },
})
```
<details>
<summary>My config</summary>

- [vim-startify](https://github.com/mhinz/vim-startify): My preferred start page plugin.
- [flatten.nvim](https://github.com/willothy/flatten.nvim): Prevent nesting terminal sessions within Neovim. Incredible stuff!

```lua
-- Lazy config terminal
return {
  {
    "jaimecgomezz/here.term",
    dependencies = { "mhinz/vim-startify" },
    opts = { startup_command = "Startify" },
  },
  {
    "willothy/flatten.nvim",
    priority = 1001,
    opts = function()
      local saved_terminal

return {
        callbacks = {
          should_block = function(argv)
            return vim.tbl_contains(argv, "-b") or vim.tbl_contains(argv, "-d")
          end,
          pre_open = function()
            if vim.bo.buftype == "terminal" then
              saved_terminal = vim.api.nvim_get_current_buf()
            end
          end,
          post_open = function(bufnr, winnr, ft, is_blocking)
            if is_blocking and saved_terminal then
              saved_terminal:close()
            else
              vim.api.nvim_set_current_win(winnr)
            end
          end,
          block_end = function()
            vim.schedule(function()
              if saved_terminal then
                saved_terminal:open()
                saved_terminal = nil
              end
            end)
          end,
        },
      }
    end,
  },
}
```
</details>

## API

Additionally, you may want to toggle/kill the terminal manually or add extra keymaps through directly calling the
following methods:

```lua
require("here-term").toggle_terminal()  -- <C-;>
require("here-term").kill_terminal()    -- <C-S-;>
```

## Workflow

1. Open any file you wish to edit.
2. Press `<C-;>` in `normal` mode. A terminal instance will replace the file you're editing.
3. Start typing your commands, you'll be on `terminal` mode by default.
4. Press `<C-;>` within the terminal. The buffer you were editing will replace the terminal.
5. Continue editing your file.
6. If the terminal is no longer useful to you, kill it with `<C-S-;>`.
7. If you ever need the terminal again, press `<C-;>`.

## Why

I've used most of the terminal solutions out there, tempted by the next shiny plugin that I could add to my neovim config, but I'd always ended up using a single terminal instance and barely scratching their full potential.

I now realize that that's ok, even ideal. Most of the complex stuff, like running local servers, compiling your code or any other background process can be perfectly handled by any of the incredible task runner solutions out there, like [overseer.nvim](https://github.com/stevearc/overseer.nvim), which is my goto. So, for the remaining everyday stuff, a single terminal instance that can be easily toggled, without needing to switch between windows or escaping it, or any other shenanigans, has come to be my favorite solution.

If you decide to use `here.term` you can still spawn new terminals if you like, it won't interfere, you'll just have a special one that you can access at speed of light (:

here.term

here.term 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

here.term

here.term 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README