Interactive Chat

Start The TUI

yeepilot

or

yeepilot run

Use the interactive client when you want a full session with history, plan mode, file attachments, the Neural HUD, and approval prompts.

What The Runtime Looks Like

During a normal session you work with:

• the chat transcript in the center
• the input box at the bottom
• optional sidecar modules on the right
• approval prompts whenever YeePilot wants to execute commands that need review

When the prompt is empty, pressing Esc opens the full-screen Neural HUD.

The Typical Workflow

For most tasks, the flow is:

1. describe the goal in plain language
2. YeePilot studies the current context
3. it proposes commands or a plan
4. each command is risk-checked
5. you approve or reject what should run
6. YeePilot executes and summarizes the result

For larger tasks, the same loop repeats until the work is done or you stop it.

Core Slash Commands

Planning and execution style

• /plan on|off|status
• /plan <task>
• /autonomy status|high|guarded|strict_review|ultra
• /think auto|best|off|low|medium|high
• /tokenmode normal|saver

Safety and environment

• /mode strict|moderate|permissive
• /sandbox on|off|status|net|nonet
• /mouse on|off|toggle|status

Sessions and output

• /new
• /rename <name>
• /sessions
• /history
• /history search <query>
• /status
• /context
• /clear
• /copy
• /export

Files and live editing

• /file <path>
• /files
• /unfile <path>
• /upload
• /livestream [on|off|status|scope <all|files|off>]
• /sidecar

Vault and secure access

• /vault ...
• /unlock [method]
• /lock
• /connect <entry>
• /connect trust <host[:port]> [fingerprint]
• /portable export|import <bundle.ypbundle>

Setup and UI

• /model
• /setup
• /language
• /theme
• /settings
• /keybinds
• /help
• /update
• /exit

/agent still works as a legacy alias, but the modern interactive runtime already behaves as the agentic default.

Daily Keyboard Shortcuts

Sidecar Modules

The optional right-hand panel can show:

• sysmon
• vault
• tasks
• notes
• explorer

Use:

/sidecar
/sidecar sysmon
/sidecar vault

or use Ctrl+P to open the picker.

Live Stream Panel

The live stream panel is the end-user view for file edits that happen during mutating AI actions. It helps you see what is changing while YeePilot works.

Use:

/livestream
/livestream status
/livestream scope all
/livestream scope files
/livestream off

This is especially useful when YeePilot edits project files, config files, or documents across several steps.

Mouse Capture

YeePilot can either capture mouse input for the TUI or let your terminal handle native text selection.

Use:

/mouse
/mouse on
/mouse off
/mouse status

Turn mouse capture off when you want to select and copy text using your terminal's normal selection behavior.

When To Use yeepilot exec

Use interactive chat for exploratory or multi-step work.

Use one-shot mode for a single task:

yeepilot exec --provider openai --model gpt-4o "summarize this folder"

This is useful for automation, quick checks, or CI-style runs where you do not need a persistent TUI session.

Best End-User Pattern

For non-trivial work:

1. start with /plan <task>
2. attach the real files with /file or /upload
3. keep autonomy at guarded or strict_review
4. watch the live stream when files are changing
5. export the session with /export when you need a record

For settings, session switching, usage, vault state, and custom hotkeys, continue with Neural HUD, Settings & Keybinds.