GETTING STARTED / v0.3.5

Getting started.

llterm is a native terminal workspace for your existing shells and coding agents. The current preview is available for Apple Silicon Macs and Windows x64.

Install on macOS

Download the archive below and verify its checksum if desired.
Extract the ZIP and move llterm.app into your Applications folder.
Open llterm. Use + or ⌘N to add a terminal.

Download macOS preview ↓

This preview is signed by SiteVue AI Inc. and notarized by Apple. The checksum below identifies the exact published archive. Intel Mac downloads are not available in this release.

Verify the download

Download the SHA-256 checksum file beside the ZIP, then run this in that directory:

shasum -a 256 -c llterm-0.3.5-macos-arm64-dddaf523e803.zip.sha256

Install on Windows

Download the Windows x64 portable preview, extract the ZIP, and run llterm.exe. This preview is unsigned. A SHA-256 checksum is available for the archive.

Make a workspace

⌘N adds a pane and arranges a balanced grid.
⌘⇧G or Grid rearranges an existing workspace.
⌘] and ⌘[ move between panes.
Click the zoom icon between ··· and × to expand a pane; click it again to restore the layout. ⌘⇧Z also toggles zoom on Mac.
Dragging a divider or choosing Equalize enters Manual sizing. Auto size resumes attention sizing.
⌘⇧T opens the theme picker. A recognized CLI’s theme is remembered.

Drop files into a terminal

Drag files or folders from Finder onto a terminal pane to insert their quoted paths at its current input position. Multiple files are separated by spaces. The drop does not press Enter.

Bring your agents

Run an installed CLI in any shell, or choose an installed profile from Launch. On macOS, llterm detects known local foreground harnesses, including Codex and Grok, through aliases and native launch wrappers.

Identifying a CLI and understanding its current activity are separate. Supported provider hooks supply lifecycle evidence. Without that evidence, the activity badge stays Unknown. Silence never becomes Done by itself. Use the state badge for evidence details and a manual override.

Provider setup and detailed compatibility notes are bundled inside the application at Contents/Resources/docs/INTEGRATIONS.md. llterm does not replace your agent’s authentication or permission settings.

What gets remembered?

Pane layout, directories, titles, and theme preferences are saved locally. Reopening a workspace starts fresh shells. Running processes and arbitrary prior commands are not automatically restored.

CPU, GPU, and memory charts retain at most 60 readings in a circular buffer, with samples every two seconds and a two-minute age cutoff. No system telemetry history is written to disk. Terminal scrollback is bounded in memory by default.

Connect your phone

Create your llterm account with a passkey. Choose free Personal for individual use or Corporate for your organization. Personal remote access has no trial expiry. Corporate starts with 30 days free; no card is required.
On desktop llterm, open Remote and enable it. Follow Sign in to register this computer to your account or organization.
Sign in to the same account in the phone app. Tap Scan QR and scan the desktop code, or enter the code manually.
Approve the phone on your computer. Choose viewing or control. Select a terminal on the phone.

Codes expire after five minutes and work once. Repeat to add your other computers. Computers must stay awake with llterm open. Revoke a device in the desktop Remote panel to remove its permission.

Desktop 0.3.5 fits a controlled terminal to the phone’s available width and height, adapting to the keyboard, rotation and text size. Leaving the pane restores its desktop size. Swipe or use the history arrows to read older output; Live ↓ or typing returns to current output. Read-only connections keep desktop dimensions. Codex shortcuts include Shift+Left and Shift+Tab. Existing terminals keep running throughout.

Preview a local app

Start your development server on the computer.
In the companion, open Preview and enter its localhost port.
Approve that port on the desktop. The app opens the preview on your phone.

The preview uses the encrypted connection to your computer, including WebSocket traffic. It closes when you leave the preview or the app goes into the background. Sites that redirect to another local port or require a fixed browser origin may need their development-server settings adjusted.

Accounts and organizations

Manage your subscription, passkeys, computers and account from Account. Organization owners enable company joining with a code sent to their work email, then members verify their own work email to join. Owners and administrators can see the company directory, last activity and 30 days of daily activity. Owners manage seats and administrator access. Automatic seat increases are optional and stop at the owner’s chosen limit.

Corporate owners and administrators can also open Agent usage in Account to compare prompts per observed hour, hourly prompt and concurrency graphs, and time with one, two to three, or four or more agents working. Select a staff member and a 1-, 7- or 30-day range. Staff must use an updated desktop linked to the organization with Remote connected. Codex and Claude prompt counts require their provider hooks. Missing observations appear as gaps; sampled work states are not exact LLM latency or productivity scores. Prompt contents and file paths are not collected.

Personal is free, including remote access, with no payment card or trial expiry. Corporate is $25 per user per month through Stripe; Corporate remote access pauses after its 30-day trial until you subscribe. If you previously subscribed to Personal through Apple, cancel it in Apple subscription settings to stop future charges. Your Personal access stays free.

The native companion stores paired-computer credentials in operating-system secure storage. Enable Face ID or your device’s screen lock from the app to protect saved computers. Passkeys can also use Face ID, Touch ID, a PIN or a security key.

Open the browser companion ↗ · Join the iPhone and iPad TestFlight beta ↗

iOS 0.3.0 (6) is available on TestFlight for iPhone and iPad running iOS 16.4 or later. The new 0.3.3 (7) build has been uploaded and is awaiting Apple’s beta review. Scan the desktop QR from Add computer. Keep it inside the framing corners; tap the preview or Refocus if needed. You can also use iPhone Camera once iOS has refreshed its app links. Install TestFlight, open the beta link on your device, then tap Install or Update. Android is available as a test APK; Google Play billing is not included in this release.

Preview status

macOS Apple Silicon and Windows x64 have native builds and automated terminal tests. Full accessibility and broader provider approval flows still need validation. The application includes the detailed acceptance report. iOS and Android companions provide optional remote access; see the native test-build availability above.

Machine-readable release information ↗