AgentOS provides a full terminal experience optimized for touch devices. Here's everything you can do.

Virtual Keyboard

The built-in keyboard is designed for terminal use, not just text entry.

Three Modes

Switch between modes by tapping the mode buttons above the keyboard:

Quick Keys (Default)

One-tap buttons for the most common terminal interactions:

Key	Action
Y	Answer "yes" to prompts
n	Answer "no" to prompts
Enter	Submit input / confirm
Ctrl+C	Cancel / interrupt current process
Ctrl+D	Exit / send EOF
Ctrl+L	Clear terminal screen
Tab	Autocomplete
↑ / ↓	Navigate command history

This mode is perfect for interacting with AI agents that frequently ask for confirmation.

ABC Mode

Full alphabetic keyboard for typing commands and text:

Standard QWERTY layout
Shift for capitals
Common symbols accessible
Spacebar and backspace

Numbers Mode

Numeric keypad with symbols:

0-9 number keys
Common programming symbols
Arrow keys for navigation
Useful for entering numbers, IPs, ports

Keyboard Tips

Swipe left/right on the keyboard area to switch modes quickly
Long-press keys for alternate characters (where available)
The keyboard remembers your last mode per session

Touch Gestures

Terminal Gestures

Gesture	Action
Tap	Focus terminal, show keyboard
Two-finger scroll	Scroll terminal history
Pinch in/out	Zoom font size
Swipe from left edge	Open session sidebar

Git Panel Gestures

Gesture	Action
Swipe right on file	Stage file
Swipe left on file	Unstage file
Tap file	View diff

Navigation Gestures

Gesture	Action
Swipe down on modal	Close modal
Tap outside modal	Close modal
Long-press session	Show context menu

Multi-Line Input

Some AI agents (like Claude Code) support multi-line input. To enter multiple lines:

Type your first line
Press Shift+Enter (or tap the Shift+Enter button)
Continue typing on the new line
Press Enter to submit all lines

This is useful for pasting code blocks or complex prompts.

Terminal Scrolling

Scroll History

The terminal maintains a scrollback buffer. Scroll up to see previous output:

Two-finger swipe up/down
Scroll-to-bottom button appears when scrolled up

Alternate Screen

Some programs (like vim, less, htop) use an alternate screen buffer. AgentOS handles this correctly:

Smooth scrolling in alternate buffer
Proper cleanup when program exits
No mixing of normal and alternate content

Session Status Indicators

The terminal header shows real-time session status:

Status	Indicator	Meaning
Running	Green dot	Agent is actively working
Waiting	Yellow dot	Needs your input
Idle	Gray dot	No recent activity
Dead	Red dot	Session terminated

When status changes to "Waiting", you'll get a notification (if enabled).

Quick Switcher

Press Cmd+K (or Ctrl+K on Windows/Linux) to open the quick switcher:

Type to filter sessions by name
Arrow keys to navigate
Enter to switch to selected session
Works on both desktop and mobile (via menu)

Image Input (Claude Code)

Claude Code supports image input. To send an image:

Tap the image icon in the toolbar
Browse the server filesystem
Select an image file
The image path is inserted into your prompt

Supported formats: PNG, JPG, GIF, WebP

Clipboard

Copy from Terminal

Select text in the terminal:

Long-press and drag to select
Tap "Copy" in the selection menu

Paste to Terminal

Long-press in the terminal area
Tap "Paste" in the context menu
Or use Ctrl+Shift+V with a physical keyboard

Desktop vs Mobile

AgentOS adapts its terminal interface based on device:

Mobile

Full-screen terminal
Virtual keyboard
Bottom tab navigation
Swipe gestures

Desktop

Multi-pane layout (up to 4 terminals)
Physical keyboard
Left sidebar
Traditional scrollbars
Keyboard shortcuts

The same features are available on both—just optimized for each input method.

Terminal Features