# innards
Small "inline" terminal tools for jumping around source code and editing files without
clearing the shell above them.
On account of agents I spend most of my time in a terminal window these days
(and often also remote over SSH) and I missed some of the conveniences of an IDE...
but wanted something quick and nimble that didn't break flow in the shell.
These little utilities let you drop in and out of navigation and editing and
viewing files but keep what you were working on visible and integrate better into a
shell oriented workflow.
In particular: things like writing `git` commit messages, doing quick edits to source files,
finding the location of some function or symbol, doing interactive rebases, or quick
document updates.
Basically: Quick to start, and get out of your way quickly after.
## Demos
`inmacs` as an inline editor:
<p align="center">
<img src="inmacs-screencast.gif" width="845" alt="inmacs inline editor demo">
</p>
`navsplat` as an inline symbol picker:
<p align="center">
<img src="navsplat-screencast.gif" width="845" alt="navsplat inline symbol picker demo">
</p>
`inbase` as an inline interactive rebase sequence editor:
<p align="center">
<img src="inbase-screencast.gif" width="845" alt="inbase inline interactive rebase demo">
</p>
`inlog` as an inline Git log browser:
<p align="center">
<img src="inlog-screencast.gif" width="845" alt="inlog inline Git log browser demo">
</p>
## Binaries
- `navsplat`: rust-analyzer-backed Rust workspace symbol picker.
- `inmacs`: inline editor with Emacs-like navigation and editing keys.
- `inpage`: read-only inline pager with the same movement/search surface as
`inmacs`.
- `inbase`: inline Git interactive rebase sequence editor.
- `inlog`: inline Git log browser.
All five use ratatui with an inline terminal viewport, so they open below the
current prompt instead of taking over the whole screen.
## Build
```sh
cargo build --release --bins
```
The binaries will be under `target/release/`.
Build a Debian package with `cargo-deb`:
```sh
cargo install cargo-deb
cargo deb
```
The `.deb` will be written under `target/debian/`.
## Install
Install from a local checkout:
```sh
cargo install --path .
```
Install directly from git:
```sh
cargo install innards
# or
cargo install --git https://github.com/rdaum/innards.git
```
`cargo install` places the binaries in Cargo's bin directory, usually
`~/.cargo/bin`. Make sure that directory is on `PATH`.
## Requirements
`navsplat` starts `rust-analyzer` and talks to it over LSP, so `rust-analyzer`
must be on `PATH`.
`navsplat` opens selections with `$VISUAL`, then `$EDITOR`, then `vi` if neither
environment variable is set. It invokes the editor as:
```sh
$EDITOR +LINE FILE
```
Clipboard copy tries `wl-copy`, `xclip`, `xsel`, `pbcopy`, then OSC 52.
## navsplat
Run the interactive picker from inside a Rust project:
```sh
navsplat
```
Start with an initial query:
```sh
navsplat pick '#main'
```
Use a specific workspace root or editor:
```sh
navsplat --root ~/src/my-crate --editor 'vim' pick HashMap
```
Print matches without opening the TUI:
```sh
navsplat symbols '#main'
```
Options:
```text
--root PATH Workspace root. Defaults to the nearest Cargo.toml or .git.
--editor CMD Editor command. Defaults to $VISUAL, $EDITOR, then vi.
--height ROWS Inline picker height. Defaults to 20.
```
Picker keys:
```text
Enter Open the selected symbol, or promote a selected side-pane hit
Esc, Ctrl-C Quit
q Quit when the search input is empty
Up/Down Move selection
Ctrl-P/Ctrl-N Move selection
PageUp/PageDown Move by larger steps
Shift-Up/Down Scroll the preview pane
Tab Switch focus between symbols and the side pane
Alt-R Show references
Alt-C Show callers
Alt-E Show callees
Alt-S Return the right pane to source preview mode
Backspace Pop back after promoting a side-pane hit
Alt-Y Copy the selected location
```
The preview is centered around the selected symbol when possible. References,
callers, and callees are loaded lazily for the current selection.
## inmacs
Open a file in the inline editor:
```sh
inmacs src/lib.rs
```
Open at a line:
```sh
inmacs +120 src/lib.rs
inmacs --line 120 src/lib.rs
```
Set the inline viewport height:
```sh
inmacs --height 18 src/lib.rs
```
Core keys:
```text
Ctrl-X Ctrl-S Save
Ctrl-X Ctrl-C Quit
Ctrl-X 1 Expand to the full terminal height
Ctrl-X 0 Restore the previous inline height
Ctrl-S Incremental search forward
Ctrl-R Incremental search backward
Ctrl-S/Ctrl-R Repeat search while searching
Enter Finish search while searching
Esc, Ctrl-G Cancel search while searching
Ctrl-G Cancel active mark outside search
Ctrl-A/Ctrl-E Start/end of line
Ctrl-B/Ctrl-F Character left/right
Alt-B/Alt-F Word left/right
Alt-Q Fill/reflow the current paragraph
Ctrl-Left/Right Word left/right
Ctrl-P/Ctrl-N Line up/down
Alt-V/Ctrl-V Page up/down
PageUp/PageDown Page up/down
Alt-Up/Down Shrink/grow the inline viewport
Ctrl-Space Set or clear mark
Ctrl-W Kill active region
Alt-W Copy active region
Ctrl-Y Yank
Ctrl-K Kill to end of line
Ctrl-D/Delete Delete character
Backspace Delete backward
Ctrl-/ Ctrl-_ Undo
Ctrl-7 Undo
Ctrl-? Redo, where the terminal reports it distinctly
```
When editing Git commit message files such as `COMMIT_EDITMSG`, `inmacs`
uses commit-message rules: 50 columns for the subject, 72 columns for body
fill and auto-wrap, a required blank line before the body, and ignored `#`
comment lines.
`inmacs` uses `ropey` internally for text storage and `syntect` for syntax
highlighting.
## inpage
Open a read-only inline pager:
```sh
inpage src/lib.rs
inpage +120 src/lib.rs
```
`inpage` accepts the same `--height`, `--line`, and `+LINE` arguments as
`inmacs`. Editing keys are disabled, but movement and search keys are shared.
When `inpage` exits, it leaves the final page content in the terminal without
the inline borders.
Additional pager quit keys:
```text
Esc
q
```
## inbase
Use `inbase` as Git's interactive rebase sequence editor:
```sh
git config --global sequence.editor inbase
# or
GIT_SEQUENCE_EDITOR=inbase git rebase -i HEAD~8
```
`inbase` edits the rebase todo file that Git passes to `$GIT_SEQUENCE_EDITOR`.
It writes the todo file and exits successfully when saved; abort exits non-zero
without writing.
Set the inline viewport height:
```sh
inbase --height 18 .git/rebase-merge/git-rebase-todo
```
Rebase keys:
```text
Ctrl-X Ctrl-S Save and continue the rebase
Ctrl-X Ctrl-C Prompt to save, abort, or cancel
s/a/c Save, abort, or cancel while the quit prompt is open
Ctrl-P/Ctrl-N Move selection up/down
Up/Down Move selection up/down
Alt-P/Alt-N Move selected todo line up/down
Alt-V/Ctrl-V Page up/down
PageUp/PageDown Page up/down
p Pick
r Reword
e Edit
s Squash
f Fixup
d Drop
x Exec, for existing exec lines only
```
## inlog
Browse Git history in an inline log viewer:
```sh
inlog
inlog -- --author ryan --since 2.weeks
inlog -- origin/main..HEAD -- src/inline_text.rs
```
`inlog` passes normal `git log` filters, revisions, paths, and sorting options
through to Git, but does not support `--graph`. If no max-count option is
provided, it loads the most recent 500 commits. When `inlog` exits, it collapses
the inline viewport and prints a compact highlighted summary for the selected
commit with the subject capped at 50 characters.
Set the inline viewport height:
```sh
inlog --height 24 -- -n 100
```
Log keys:
```text
Ctrl-S Incremental search forward
Ctrl-R Incremental search backward
Enter Select commit, copy SHA, and quit; finish search while searching
Esc, Ctrl-G Cancel search while searching
Ctrl-P/Ctrl-N Move selection up/down
Up/Down Move selection up/down
Alt-V/Ctrl-V Page up/down
PageUp/PageDown Page up/down
Alt-Up/Alt-Down Shrink/grow the inline viewport
Ctrl-X 1 Expand to the full terminal height
Ctrl-X 0 Restore the previous inline height
/ Expand/collapse the selected commit message
Alt-Y Copy the selected full SHA
q, Esc Quit
Ctrl-X Ctrl-C Quit
```
## Configuration
Innards reads TOML configuration from:
```text
$XDG_CONFIG_HOME/innards/config.toml
```
If `XDG_CONFIG_HOME` is not set, it falls back to:
```text
~/.config/innards/config.toml
```
Example:
```toml
[inmacs]
fill_column = 100
[keybindings.inline]
fill_paragraph = "alt-q"
fullscreen = "ctrl-x 1"
restore_inline = "ctrl-x 0"
save = "ctrl-x ctrl-s"
quit = "ctrl-x ctrl-c"
search_forward = "ctrl-s"
search_reverse = "ctrl-r"
page_up = ["alt-v", "pageup"]
page_down = ["ctrl-v", "pagedown"]
[keybindings.navsplat]
open = "enter"
quit = ["esc", "ctrl-c"]
toggle_focus = "tab"
references = "alt-r"
callers = "alt-c"
callees = "alt-e"
source = "alt-s"
copy = "alt-y"
[keybindings.rebase]
save = "ctrl-x ctrl-s"
quit = "ctrl-x ctrl-c"
select_prev = ["ctrl-p", "up"]
select_next = ["ctrl-n", "down"]
move_up = "alt-p"
move_down = "alt-n"
pick = "p"
reword = "r"
edit = "e"
squash = "s"
fixup = "f"
drop = "d"
[keybindings.log]
quit = ["ctrl-x ctrl-c", "esc", "q"]
search_forward = "ctrl-s"
search_reverse = "ctrl-r"
select_prev = ["ctrl-p", "up"]
select_next = ["ctrl-n", "down"]
shrink_height = "alt-up"
grow_height = "alt-down"
fullscreen = "ctrl-x 1"
restore_inline = "ctrl-x 0"
toggle_expand = "/"
copy = "alt-y"
accept = "enter"
```
Configured action bindings replace the built-in bindings for that action.
Unmentioned actions keep their defaults. Key names are case-insensitive and can
use modifiers such as `ctrl-`, `alt-`, and `shift-`. Multi-key sequences are
written with spaces, for example `ctrl-x ctrl-s`.
Inline actions shared by `inmacs` and `inpage`:
```text
quit, save, search_forward, search_reverse, cancel_search, finish_search,
cancel_mark, set_mark, undo, redo, line_start, line_end, word_left,
word_right, char_left, char_right, line_up, line_down, page_up, page_down,
copy_region, kill_region, kill_to_eol, yank, delete_char, backspace,
insert_newline, insert_tab, shrink_height, grow_height, fullscreen,
restore_inline, fill_paragraph, quit_view
```
`navsplat` actions:
```text
quit, quit_if_empty, open, pop, toggle_focus, references, callers, callees,
source, copy, select_prev, select_next, preview_up, preview_down, page_up,
page_down, delete_next_char
```
`inbase` actions:
```text
save, quit, select_prev, select_next, move_up, move_down, page_up, page_down,
pick, reword, edit, squash, fixup, drop, exec, prompt_save, prompt_abort,
prompt_cancel
```
`inlog` actions:
```text
quit, search_forward, search_reverse, cancel_search, finish_search,
search_backspace, select_prev, select_next, page_up, page_down, shrink_height,
grow_height, fullscreen, restore_inline, toggle_expand, copy, accept
```
## Development
Useful checks:
```sh
cargo fmt
cargo check --bins
cargo test --lib
cargo build --bins
```
GitHub Actions runs formatting, Clippy, tests, and release binary builds on
pushes to `main` and pull requests. Pushing a `v*` tag builds the Debian package
and uploads it to the corresponding GitHub Release; the Debian package workflow
can also be run manually from the Actions tab.
## License
`innards` is licensed under GPL-3.0-only. See `LICENSE`.