64 releases (27 breaking)
0.31.0 | Jan 16, 2023 |
---|---|
0.30.0 | Sep 29, 2022 |
0.29.0 | Aug 4, 2022 |
0.28.0 | Jul 1, 2022 |
0.1.0 | Apr 22, 2020 |
#146 in Text editors
195 downloads per month
Used in 2 crates
1MB
23K
SLoC
A simple and opinionated modal code editor for your terminal
Pepper is an experiment of mine to simplify code editing from the terminal. It's mission is to be a minimal and fast code editor with an orthogonal set of both editing and navigation features.
help page
default keybindings
command reference
expansion reference
defining language syntaxes
config recipes
changelog
try it on your browser!
installation
binaries
Pepper is open-source, which means you're free to build it and access all of its features. However, to support the development, prebuilt binaries are available for purchase at itch.
This will not only keep you updated with the latest features/fixes but also support further pepper development!
using cargo
Simply running cargo install pepper
will get you the vanilla pepper editor experience.
However, if you also want LSP support,
you can run cargo install pepper-plugin-lsp
which will install the pepper editor together with its lsp plugin.
from source
cargo install --git https://github.com/vamolessa/pepper pepper
NOTE(1): installing from source still requires cargo
(at least it's easier this way).
NOTE(2): installing from source will actually install the editor with the configurations I use (you can check my setup).
if you find a bug or need help
Please open an issue
goals
- small, however orthogonal, set of editing primitives
- mnemonic and easy to reach default keybindings (assuming a qwerty keyboard)
- cross-platform (Windows, Linux, BSD, Mac and even Web)
- extensible through external cli tools
- be as fast and reponsive as possible
- zero runtime dependencies (besides platform libs)
non goals
- support every possible workflow (it will never ever get close to feature parity with vim or emacs)
- complex ui (like breadcumbs, floating windows, extra status bars, etc)
- multiple viewports (leave that to your window manager/terminal multiplexer). Instead clients can connect to each other and act together as if they're a single application)
- undo tree
- support for text encodings other than UTF-8
- fuzzy file picker (you can integrate with fzf, skim, fd, etc)
- workspace wide search (you can integrate with grep, ripgrep, etc)
- having any other feature that could instead be implemented by integrating an external tool
features
- everything is reachable through the keyboard
- modal editing
- multiple cursors
- caret style cursors (like most text editors, cursors can move past last line character and text is always inserted to its left)
- text-object selection
- keyboard macros
- client/server architecture
- simple syntax highlighting
- language server protocol
philosophy
In the spirit of Handmade, all features are coded from scratch using simple stable Rust code. These are the only external crates being used in the project:
winapi
(windows-only): needed to implement the windows platform layerlibc
(unix-only): needed to implement the unix platform layerwasm-bindgen
(web-only): needed to implement the web platform layer
modal editing
Pepper is modal which means keypresses do different things depending on which mode you're in.
However, it's also designed to have few modes so the overhead is minimal. Most of the time, users will be in
either normal
or insert
mode.
comparing to vim
Like Vim, you have to actively start text selection.
However, unlike it, you can also manipulate selections in normal mode.
Also, there's no 'action' then 'movement'. There's only selections and actions.
That is, d
will always only delete selected text. If the selection was empty, it does nothing.
Pepper expands on Vim's editing capabilities by supporting multiple cursors. This enables you to make several text transformations at once. Also, cursors behave like carets instead of blocks and can always go one-past-last-character-in-line.
In config recipes you'll find some basic "vim-like" keybindigns for more vim comparisons.
comparing to kakoune
Like Kakoune, you can manipulate selections while in normal mode and actions always operate on selections.
However, unlike it, normal mode remembers if you're selecting text or nor (think a pseudo-mode).
This way, there's no need for extra alt-
based keybindings.
Pepper is heavily inspired by Kakoune's selection based workflow and multiple cursors. However its cursors behave like caret ranges instead of block selections. That is, the cursor is not a one-char selection but only a visual cue to indicate the caret location.
keybindings at a glance
Also at keyboard-layout-editor.
development thread
It's possible to kinda follow Pepper's development history in this twitter thread
support pepper development
Pepper is open-source, which means you're free to build it and access all of its features.
However, prebuilt binaries are available for purchase at itch.
<iframe src="https://itch.io/embed/810985?linkback=true" width="552" height="167" frameborder="0"> pepper code editor by Matheus Lessa Rodrigues </iframe>You can also directly buy me a coffee :)
Please consider supporting Pepper's development and I'll be forever grateful :)