A Complete Guide to the EONYX Interactive TUI

The main way to work with EONYX is the terminal interface.
Streaming answers, a command palette, pickers and dialogs.
Here is everything worth knowing to move fast.

1 ⌨️ Keyboard and commands

1.1 Hotkeys

1.2 Command palette

/ on empty input, or Ctrl+P, opens the palette.
It has two tabs and Tab switches between them.
System commands: new session, clear context, yolo, plan, timestamps, switch model, sessions, capabilities, quit.
Working ones: attach, check, IP, export.
Arrows wrap around and Enter runs.

Slash commands also work 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 lists the configured models, with the current one marked.
• Sessions. Ctrl+S or /sessions opens the list. r renames, f forks, d deletes. /sessions <query> searches titles and text.
• Files. Type @ and start a path. A candidate menu appears, directories first, and Tab inserts. That is the quick way to attach files to a message.

2 🖥️ What is on screen

2.1 Header

The header carries the working directory, the git branch and the session number or title.
Then the mode: SAFE, YOLO or PLAN.
Then 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 Skills and MCP tabs.
Any skill or server flips off and on with ✓ and ✗.
For a skill that rebuilds the catalogue in the system prompt.
For MCP it hides the server’s tools from the model.
The header shows what is active, in # skills and » mcp.

2.3 Output and reasoning

• Ctrl+O switches tool output between a short summary and the full text. Long listings and files are collapsed by default so the transcript stays readable.
• Ctrl+R expands the model’s thinking block, on reasoning models. It is collapsed to one line by default.

3 💬 Actions from the chat

3.1 Shell in the chat

!<command> runs in the agent’s shared shell session.
It writes the command and its output into the conversation.
So the model sees what you did and how the state changed, directory and variables included.

! go test ./...

3.2 Export and fork

• /export saves the conversation to markdown, at <project>/.eonyx/exports/eonyx-<id>.md.
• /fork, or f in the session list, branches the conversation into a new session and leaves the original alone. A handy save point before a risky direction.

4 📋 Summary