https://github.com/aelesbao/tmux-ctrlp
https://github.com/aelesbao/tmux-ctrlp
Last synced: 6 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/aelesbao/tmux-ctrlp
- Owner: aelesbao
- License: mit
- Created: 2023-12-14T15:46:56.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-02-03T19:59:24.000Z (5 months ago)
- Last Synced: 2026-02-04T08:48:20.201Z (5 months ago)
- Language: Shell
- Size: 44.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Session manager for TMUX
Another tmux session manager. Adapted from [ThePrimeagen's script] with a few
tweaks and extra inspiration from other plugins.
## Motivation
## How it works
## Dependencies
For this plugins to work, you should have installed:
- zsh
- fd
- fzf
- zoxide
- eza
## Installation
### Using [TMUX Plugin Manager](https://github.com/tmux-plugins/tpm)
```tmux
set -g @plugin 'aelesbao/tmux-ctrlp'
```
Press `prefix + I` to install the plugin.
### Manual Installation
Clone the repo:
```sh
git clone https://github.com/aelesbao/tmux-ctrlp ~/.tmux/plugins/tmux-ctrlp
```
Add this line to the bottom of your `.tmux.conf`:
```tmux
run ~/.tmux/plugins/tmux-ctrlp/ctrlp.tmux
```
Reload your `tmux` environment:
```sh
source-file ~/.tmux.conf
```
## Key bindings
| Binding | Option | Description |
|:-------:|:------:|-------------|
| ` C-p` | `@ctrlp_project_bind` | Fuzzy find across your defined workspace projects |
| ` C-s` | `@ctrlp_session_bind` | Fuzzy find across existing sessions with preview |
You can change the default bindings adding the following to your `tmux` config:
```tmux
# Remap in case you use as you tmux prefix and want to send double C-s to
# the terminal
set -g @ctrlp_session_bind 's'
```
## Configuration
**TODO**.
Copy the [example config] to `~/.config/tmux/ctrlp.config.zsh` and use it as a
reference on how to setup the project folder and workspaces.
## License
[MIT](LICENSE.md)
[ThePrimeagen's script]: https://github.com/ThePrimeagen/.dotfiles/blob/master/bin/.local/scripts/tmux-sessionizer
[example config]: ./ctrlp.config.example.zsh