coder / coder/claudecode.nvim

[FEATURE] Support custom wrapper commands (like shell functions/aliases) for terminal_cmd

Open
#135 0 comments 1 reaction 0 assignees View on GitHub
Dominant language
Lua
Stars
3.1k
Forks
216
PR merge metrics
No merged PRs in 30d

Description

## Feature Description

Support for using **custom wrapper commands** (e.g. shell functions or aliases) as `terminal_cmd` in `claudecode.nvim`.
Currently, `terminal_cmd` only works with executables available in the shell PATH. When using a shell function (e.g. `cl`), it fails with exit code 127.

## Use Case

I created a custom shell function `cl` that wraps `claude` with additional custom prompts.
I’d like to use this wrapper command with `claudecode.nvim` so that every request automatically follows my predefined prompt rules.
This would make it easier for users to customize their workflows without modifying the plugin code.

## Proposed Solution

Allow `terminal_cmd` to support shell functions or aliases in addition to executables.
For example, running the command through a shell (e.g. `bash -i -c "cl"`) so that user-defined functions are available.

## Alternatives Considered

- Directly using the `claude` binary instead of the wrapper (works, but loses my custom prompt logic).
- Writing a separate executable script (`~/bin/cl`) instead of a shell function (possible, but less convenient for quick customization).

## Additional Context

Error message when attempting to use a shell function as `terminal_cmd`:

[ClaudeCode] [terminal] [ERROR] Claude exited with code 127.
Check for any errors.

```lua
Example config:

{
"coder/claudecode.nvim",
dependencies = { "folke/snacks.nvim" },
opts = {
terminal_cmd = "cl",
terminal = {
snacks_win_opts = {
...
},
},
},
}

```

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.