Skip to content

Commit 4a46460

Browse files
cpcloudclaude
andcommitted
docs(website): document clipboard yank and OSC 52 terminal config
Add y keybinding to Nav mode table, clipboard section with OSC 52 terminal configuration requirements (tmux, iTerm2, kitty, etc.). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent ed6c81d commit 4a46460

1 file changed

Lines changed: 27 additions & 0 deletions

File tree

docs/content/docs/using/navigation.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,10 +31,37 @@ have full table navigation:
3131
| <kbd>ctrl+n</kbd> | Clear all pins and filter |
3232
| <kbd>tab</kbd> | Toggle house profile |
3333
| <kbd>D</kbd> | Toggle dashboard |
34+
| <kbd>y</kbd> | Copy cell value to clipboard |
3435
| <kbd>i</kbd> | Enter Edit mode |
3536
| <kbd>@</kbd> | Open LLM chat |
3637
| <kbd>?</kbd> | Help overlay |
3738

39+
### Clipboard (yank)
40+
41+
Press <kbd>y</kbd> to copy the focused cell's value to the system clipboard.
42+
The status bar briefly shows the copied value. Money values are copied
43+
without the currency symbol.
44+
45+
micasa uses [OSC 52](https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h3-Operating-System-Commands)
46+
to set the clipboard directly through the terminal. This works over SSH
47+
and doesn't require external tools like `xclip` or `xsel`. Most modern
48+
terminals support it, but some need explicit configuration:
49+
50+
| Terminal | Configuration |
51+
|----------|---------------|
52+
| tmux | `set -g set-clipboard on` in `~/.tmux.conf` |
53+
| GNU Screen | `bindkey -d -k kb stuff "\010"` — limited support |
54+
| Alacritty | Enabled by default |
55+
| iTerm2 | Preferences → General → Selection → enable "Applications in terminal may access clipboard" |
56+
| kitty | Enabled by default |
57+
| WezTerm | Enabled by default |
58+
| Windows Terminal | Enabled by default |
59+
| foot | Enabled by default |
60+
| GNOME Terminal | Supported since 3.46 |
61+
62+
If your terminal doesn't support OSC 52, the keypress is silently
63+
ignored — nothing breaks, you just don't get clipboard content.
64+
3865
## Edit mode
3966

4067
Press <kbd>i</kbd> from Nav mode to enter Edit mode. The status bar shows an orange

0 commit comments

Comments
 (0)