A Complete Guide to the EONYX Interactive TUI

The main way to work with EONYX is the interactive terminal interface (TUI): response streaming, the command palette, pickers and dialogs. Here is everything worth knowing to work fast.

1 Keyboard and commands

Almost everything in EONYX is done from the keyboard — here are the main keys, the palette and the pickers.

1.1 Hotkeys

1.2 Command palette

/ (on empty input) or Ctrl+P opens the palette with two tabs (switch with Tab): system commands (new session, clear context, yolo, plan, timestamps, switch model, sessions, capabilities, quit) and working ones (attach, check, IP, export). Arrows wrap around, Enter runs.

Slash commands can also be typed by hand: /new, /clear, /add [path], /rename <title>, /fork, /export, /yolo, /plan, /timestamps, /model, /sessions [query], /help, /quit.

1.3 Pickers and completion

• Model — Ctrl+N or /model: the list of configured models, the current one is marked.
• Sessions — Ctrl+S or /sessions: the list; r rename, f fork, d delete; /sessions <query> searches titles and text.
• Files — type @ and start typing a path: a candidate menu appears (directories first), Tab inserts. A convenient way to “attach” files to a message.

2 What is on screen

The header shows the state, and a couple of toggles control what is visible in the transcript.

2.1 Header

The header shows the working directory, the git branch, the session number/title, the mode (SAFE / YOLO, PLAN), the model and the counters: input↑ output↓, cached tokens, session time, cost $… and the context indicator {ctx N%}.

2.2 Skills and MCP

Ctrl+K opens the capabilities dialog with the Skills and MCP tabs. Any skill or MCP server can be turned off/on on the fly (✓/✗): for skills this rebuilds the catalog in the system prompt, for MCP it hides the server’s tools from the model. Active skills and servers are visible in the header (# skills, » mcp).

2.3 Output and reasoning

• Ctrl+O — toggles tool output between a short summary and the full text. By default long listings and files are collapsed so they do not clutter the transcript.
• Ctrl+R — expands/collapses the model’s “thinking” block (for reasoning models). Collapsed to a single line by default.

3 Actions from the chat

From the chat you can run shell commands and manage the session itself.

3.1 Shell in the chat

!<command> runs it in the agent’s shared shell session, and writes the command and its output into the conversation — so the model sees what you did and how the state changed (directory, variables):

! go test ./...

3.2 Export and fork

• /export — saves the conversation to markdown: <project>/.eonyx/exports/eonyx-<id>.md.
• /fork (or f in the session list) — branches the conversation into a new session, the original is left unchanged. Handy as a “save point” before a risky direction.

4 Summary