VIGIL — The Original Text Intelligence OS

MANIFESTO

THE VIGIL PHILOSOPHY

Your hands should never leave the keyboard.

Before there were IDEs, before there were mice, before the entire world decided that text editing should resemble a word processor, there was VIGIL. A modal editor. A thinking machine. A language unto itself.

VIGIL was not designed to be learned in an afternoon. It was designed to be mastered over a lifetime. Every command is a verb. Every motion is a noun. Every edit is a sentence. When you speak VIGIL, you don't click and drag — you think and act. d2w. Delete two words. ci". Change inside quotes. The grammar is composable, the vocabulary is infinite, and the fluency is indistinguishable from thought.

We don't apologize for the learning curve. The learning curve is the product.

Text editing is not a feature. It is a discipline.

CAPABILITIES

POWERS OF THE
ANCIENT EDITOR

Every feature forged over five decades of relentless optimization.

⌨️

Modal Architecture

Four distinct modes — Normal, Insert, Visual, and Command — each purpose-built for a class of operations. Context-switching at the speed of a single keystroke. No mode confusion. Only mode mastery.

Esc → i → Esc → :wq

🎯

Composable Grammar

Vi commands are a language: verbs (d, c, y) combine with motions (w, $, gg) and counts. 3dw deletes three words. y5j yanks five lines down. Infinite combinations from finite primitives.

d3w · ci" · y$ · gUiw

⚡

hjkl Navigation

Move through text without ever reaching for arrow keys. hjkl — left, down, up, right. Your fingers stay on the home row. Every millisecond saved compounds into hours of recovered focus.

h ← j ↓ k ↑ l →

🔄

The Dot Command

The most powerful key in computing: . repeats your last edit. Change a word, then . to change the next. Delete a line, then . to delete another. Macro-level power from a single character.

ciw → new_name → Esc → n → .

🔍

Pattern Search & Replace

Search with /pattern, navigate matches with n/N, and replace across entire files with :%s/old/new/g. Full regular expression support. No find-and-replace dialog. Just intent, expressed.

:%s/legacy/modern/gc

📼

Macro Recording

Record any sequence of keystrokes with qa, replay with @a, and run across ranges with 100@a. Your edits become reusable programs. Every repetitive task, automated in seconds.

qa → edits → q → 99@a

MODAL ARCHITECTURE

FOUR MODES.
INFINITE POWER.

Switch between modes to unlock different capabilities. Click any mode to explore.

NORMAL MODE

Esc

The command center. Navigate, delete, yank, paste, and compose operations. This is where you think. Every key is a command, not a character.

h j k lMove left / down / up / right

w b eWord forward / back / end

0 $Start / end of line

gg GStart / end of file

ddDelete entire line

yyYank (copy) entire line

p PPaste after / before cursor

uUndo last change

.Repeat last edit

xDelete character at cursor

INSERT MODE

i / a / o

The writing zone. Characters you type are inserted into the buffer. Enter with precision — i before cursor, a after, o new line below, O above.

iInsert before cursor

aAppend after cursor

oOpen new line below

OOpen new line above

IInsert at beginning of line

AAppend at end of line

EscReturn to Normal mode

Ctrl-TIndent current line

Ctrl-DDe-indent current line

Ctrl-WDelete word before cursor

VISUAL MODE

v / V / Ctrl-V

Select text visually, then operate on it. Character-wise, line-wise, or block-wise. See exactly what you're about to transform.

vCharacter-wise selection

VLine-wise selection

Ctrl-VBlock (column) selection

dDelete selected text

yYank (copy) selected text

cChange selected text

>Indent selection

<< /kbd>De-indent selection

~Toggle case of selection

EscReturn to Normal mode

COMMAND MODE

The ex command line. Write, quit, substitute, set options, and execute shell commands — all from a single colon prompt.

:wSave (write) file

:qQuit editor

:wqSave and quit

:q!Force quit without saving

ZZSave and quit (shortcut)

:%s/a/b/gSubstitute all occurrences

:set numberShow line numbers

:!cmdExecute shell command

:r fileRead file into buffer

:e fileEdit another file

ARCHITECTURE

THE EDITING CYCLE

The four-phase workflow that turns keystrokes into poetry.

Enter Normal Mode

Every session begins in Normal mode. Navigate to the exact position. gg to start. /function to search. 23G to jump to line 23. Precision before action.

Compose Your Edit

Think in VIGIL grammar: verb + motion. dw — delete word. ci( — change inside parentheses. y$ — yank to end of line. One thought, one command.

Execute & Repeat

Press . to replay your last edit wherever the cursor lands. Navigate with n, repeat with .. The compound effect of composable operations.

Save & Persist

:w writes your buffer to disk. :wq writes and exits. ZZ for the initiated. Your text is preserved. Your session is complete.

DEVOTEES

THEY ASCENDED.
THEY NEVER RETURNED.

"I spent three hours trying to exit VIGIL. Then I spent three years mastering it. The ROI is incalculable. I refactored our entire codebase with nothing but macros and the dot command."

Raj Nakamura Principal Engineer, Apex Systems

"My team mocked me for using VIGIL. Then they watched me do a column edit across 400 lines with Ctrl-V, I, a prefix, Esc. In four keystrokes. Nobody's laughing now."

Maya Ramirez Staff SRE, InfraCore

":%s/mediocre/excellent/g — that's not a command, it's a lifestyle. VIGIL taught me that every repetitive task is a macro waiting to be recorded."

David Fischer CTO, Lattice Engineering

"I SSH'd into a production server at 3 AM. No GUI. No VS Code. Just VIGIL and the will to survive. It was the only tool that didn't need an internet connection, a plugin manager, or a prayer."

Serena Rodriguez VP Infrastructure, DeployFast

FAQ

QUESTIONS. ANSWERED.
IN NORMAL MODE.

How do I exit VIGIL?

This is the first question every initiate asks — and the last question they ever need to ask twice. Press Esc to ensure you're in Normal mode, then type :q and press Enter. To save first: :wq. To quit without saving: :q!. To save and quit in two keystrokes: ZZ. You're welcome.

Why are there multiple modes? Isn't that confusing?

Modes are not a limitation — they are a liberation. In a modeless editor, every key types a character. In VIGIL, in Normal mode, every key is a command. This means the entire keyboard becomes a command palette. No Ctrl-Shift-Alt acrobatics. Just single keys that do powerful things. The modal architecture means more commands with fewer keystrokes.

What's the difference between VIGIL and vim?

Vi is the original, standardized by POSIX and available on every Unix system since 1976. Vim ("Vi IMproved") is a compatible superset with additional features. VIGIL honors the original specification while providing the extended capabilities you've come to expect. Think of it as the canon, not the fanfic.

Can VIGIL really replace a modern IDE?

Vi doesn't want to replace your IDE. Vi wants to replace the part of your brain that reaches for a mouse. An IDE gives you buttons. VIGIL gives you a language. The question isn't "can VIGIL do what my IDE does" — the question is "can my IDE do qa0f,r;jq47@a?"

Is the learning curve really worth it?

The average developer types for 30+ years. The VIGIL learning curve is measured in weeks. The productivity gains compound over decades. You wouldn't refuse to learn your native language because "babbling was easier." VIGIL is fluency in text manipulation. The curve is the investment; the payoff is permanent.

THE ORIGINAL
TEXT INTELLIGENCE
OPERATING SYSTEM

THE VIGIL PHILOSOPHY