Tuck a book into the margins of your workday.
Sip is a VS Code extension that displays a plain-text book alongside whatever you're working on — tucked into the status bar, rendered as ghost text at the end of a line, disguised as code comments, or surfaced in the native hover popup. Page size is measured in columns, so CJK and Latin books both wrap correctly.
Getting started
- Run Sip: Open Book from the command palette and pick a
.txtfile. - Pick a reading mode (
Sip: Toggle Reading Modeor thesip.readingModesetting). - Page through with
Ctrl+[/Ctrl+]on macOS, orAlt+[/Alt+]on Windows / Linux / WSL.
Your position is saved per book path and survives reloads.
Reading modes
| Mode | What it looks like |
|---|---|
statusBar |
One line packed into the status bar — most discreet. |
inlineGhost |
Faded italic text at the end of the current line, like a Copilot hint. |
pseudoComment |
Several lines of book text rendered as fake code comments just below the cursor. |
hoverTooltip |
Current page shown in the native hover popup when you mouse over code. |
All modes share the same paginator, so switching mode keeps the same text in view.
Settings
| Setting | Default | What it does |
|---|---|---|
sip.bookPath |
"" |
Absolute path to the book file (.txt). |
sip.readingMode |
statusBar |
statusBar | inlineGhost | pseudoComment | hoverTooltip. |
sip.visible |
true |
Master visibility toggle. |
sip.maxDisplayWidth |
60 |
Max display width in columns; CJK characters count as 2. |
sip.showChapterInStatusBar |
true |
Show chapter name in the status-bar tooltip. Only used by statusBar. |
sip.pseudoCommentLines |
3 |
Number of comment lines to show. Only used by pseudoComment. |
sip.hoverTooltipLines |
4 |
Number of body lines in the hover popup. Only used by hoverTooltip. |
sip.chapterDetection |
auto |
auto | custom | none. |
sip.chapterPattern |
"" |
Custom chapter regex, used only when detection is custom. |
Commands & keybindings
The second key is the same on every platform — only the modifier differs (Ctrl on macOS, Alt on Windows / Linux / WSL). On macOS, Alt/Option is a Unicode dead-key, so the bindings use Ctrl instead.
| Command | macOS | Windows / Linux / WSL |
|---|---|---|
Sip: Open Book |
— | — |
Sip: Close Book |
— | — |
Sip: Previous Sentence |
Ctrl+[ |
Alt+[ |
Sip: Next Sentence |
Ctrl+] |
Alt+] |
Sip: Toggle Reading Mode |
Ctrl+' |
Alt+' |
Sip: Toggle Visibility |
Ctrl+\ |
Alt+\ |
Sip: Go to Chapter |
— | — |
Sip: Previous Chapter |
Ctrl+Shift+[ |
Alt+Shift+[ |
Sip: Next Chapter |
Ctrl+Shift+] |
Alt+Shift+] |
License
MIT. See LICENSE.