A HERMES AGENT PLUGIN / LANGERSWORD

A REAL TERMINAL FOR THE AGENT.

ssh, vim, htop, fzf, installers, REPLs. Programs that need a keyboard, not a pipe. Pilot keeps a private tmux server, reads the pane back as text, and hands you the keys whenever you want them.

SEE THE PROOF ↓

MIT · TMUX 3.X · 54 TESTS · NO API KEY

A hand reaching toward a wireframe terminal core, reduced to one-bit dither.
01 THE CORE

01 / THE WALL

A TERMINAL TOOL IS A pipe.

One command, no TTY. htop returns repaint garbage, vim refuses input, fzf cannot open /dev/tty. The model reads control codes, or nothing at all.

THREE PROGRAMS / PIPE / TERM=dumbUNREADABLE
0[ 0.0%] 4[##* 20.0%] 8[#** 20.0%] 12[### 15.4%]1[ \nF1Help  F2Setup F3SearchF4FilterF5Tree  F6S
ortByF7Nice -F8Nice +F9Kill  F10Quit\n             \n\n
^[[24;1HVim: Warning: Output is not to a terminal
Vim: Warning: Input is not from a terminal

inappropriate ioctl for device
→ CONTROL CODES, REPAINT GARBAGE, ONE IOCTL ERROR
PILOT / TTY / 88×24READABLE
    0[||||        20.0%]   4[||||         21.4%]   8[||             7.1%] 12[|||||||       28.6%]
    1[||            6.7%]   5[||            7.1%]   9[||             7.1%] 13[|||||         23.1%]
  Mem[||||||||||||||||||||||||||||||||12.2G/14.9G] Tasks: 160, 1645 thr; 1 running
  Swp[||||||||||||||||||||||||||||||||3.48G/4.00G] Load average: 1.96 2.21 2.62
   PID USER       PRI  NI  VIRT   RES  S  CPU%  MEM%   TIME+  Command
  152297 lakshaya    20   0 11.2G  664M  S  47.1   4.4  1:01.44 firefox
  1289 lakshaya    20   0 53.0G  92M   R  23.5   0.6  1h25:38 chromium
→ A SCREEN THE MODEL CAN READ

THREE PROGRAMS. ONE PIPE. ONE TTY. CAPTURED, NOT DRAWN.

02 / THE LOOP

OPEN. SCREEN. TYPE. WAIT.

Four actions. No new mental model. The agent types into the pane, reads what a human would see, and waits for a pattern instead of sleeping.

01OPEN

Start a program in a new pane.

ssh, vim, htop, a REPL, an installer. A real TTY with a size you choose.

pilot open "ssh msi" --name remote
02SCREEN

Read the pane as text.

What a human would see, not raw ANSI: joined lines, trailing blanks trimmed, dead-pane banner removed.

pilot screen remote --lines 80
03TYPE

Send text and named keys.

Literal strings plus Escape, C-c, Up, Tab. Return by default.

pilot type remote keys="i" "port" "Escape"
04WAIT

Wait for a pattern, or quiet.

Redraws are asynchronous. Poll for a regex, or let the pane settle before reading it.

pilot wait remote "password:|[$#] $"

KEEP SCROLLING → THE RAIL MOVES

03 / THE BACKEND

THE NORMAL TERMINAL TOOL. IN A REAL TTY.

Set terminal.backend: pilot and every terminal call runs in a persistent shell. cd, exports and aliases survive across calls. A command that times out is left running, with its session name — not killed.

  • SURFACEa real TTY, 120×36
  • BACKENDtmux 3.8, private socket
  • TIMEOUT124, left attachable
  • TAKEOVERattach and type
TURN IT ON ↗
hermes — terminal.backend: pilot
$ hermes config set terminal.backend pilot
✓ set terminal.backend = pilot
$ hermes
› cd /usr && pwd
/usr
› sleep 10            # timeout=2
exit 124 · session term-local-607dd1 still running
› pilot screen term-local-607dd1
[pilot] still running after 2s. use pilot type.
$ █

THE SHELL SURVIVES THE TURN. THE PANE SURVIVES THE SHELL.

54 TESTS24 TOOLS1 HOOKTMUX 3.XMIT

04 / PLATES

THE PANES, IN ONE BIT.

Three plates made for Pilot, reduced to a two-colour dither. The terminal is the subject; the screen is the paper.

A hand pressing a key, reduced to one-bit pale-blue dither.
#01 HAND / ONE KEY
#01 / TYPE

It types into programs.

The agent sends literal text and named keys into a real pane: i, a line, Esc, :wq. The program renders; the agent reads it back.

A face reflected in a CRT, reduced to one-bit yellow dither.
#02 FACE / SAME PANE
#02 / TAKE OVER

It leaves you the keyboard.

Attach to the same tmux pane with hermes pilot attach. Anything you type is what the agent reads next. No copy step, no second shell.

A wall of terminal windows, reduced to one-bit mint dither.
#03 WALL / READ AS TEXT
#03 / READ

It reads the screen.

htop repaints, fzf takes over the display, wait polls the text until the screen settles. No escape-code parser, no screenshots.

05 / THE PORTAL

ONE ACCOUNT FOR THE WHOLE MACHINE.

Pilot is a plugin, not a platform. It runs on the Hermes you already have; the models, credits and cloud around it live in the Nous Portal.

portal.nousresearch.com / overview
// OVERVIEW

Everything to power the agent.

Hermes remembers you, works while you sleep, and lives in the apps you already use. Nous Portal is the one account that fuels all of it: the models, the tools, the cloud.

MODELSROUTED
PLUGINS1,065
CLOUDREADY

THE AGENT RUNS ON YOUR MACHINE. THE ACCOUNT LIVES AT PORTAL.NOUSRESEARCH.COM ↗

06 / MANIFESTO

DRAG THE CORE. THE TEXT PARTING AROUND IT IS MEASURED, NOT WRAPPED.

A pipe is a one-way street. A terminal is a conversation: you type, it answers, you look, you type again. Pilot keeps that conversation alive — across calls, across tools, across machines — and hands you the keyboard whenever you want it.

07 / INSTALL

PUT IT ON YOUR machine.

01

Install from the catalog

hermes plugins install pilot
02

Enable it

hermes plugins enable pilot
03

Optional: make it the terminal backend

hermes pilot backend on

TMUX 3.X · MIT · 54 TESTS · NO API KEY · WORKS OFFLINE

PILOTv0.3.1

A real TTY for the agent.

Open, read, type, wait, attach. The pane is the machine.