Terminay Documentation

Choose a topic to learn how to use Terminay. These pages focus on the app itself: workspaces, the Home dashboard, terminal workflows, automations, agents, files, project documentation, folders, tasks, macros, recordings, settings, remote access, and shortcuts.

Installation

Download Terminay, run packaged builds, or build a local copy when needed.

Workspace

Use project tabs, docked terminals, split panes, popouts, the status bar, and per-project file explorer state.

Home

See every project, tab, agent, connection, and automation in one place, as a list, a board, or project cards.

Command Bar

Search commands and macros from one keyboard-first launcher.

Macros

Create reusable sequences of terminal steps with fields, secrets, and progress tracking.

Automations

Run a command, a macro, or some text on a schedule or when an agent, terminal, project, or device event happens.

Recordings

Capture terminal sessions as local asciicast v3 files, then replay, search, reveal, or delete them from the timeline.

Settings

Customize shell behavior, terminal appearance, recordings, shortcuts, themes, accessibility, and remote access.

Agents

Follow coding-agent activity, open the right terminal, and see when an agent is working, waiting, or done.

Terminay MCP

Install the Terminay MCP server so agents can inspect and drive sibling terminal tabs and manage automations, with permissions you control.

App Windows

Let an agent or a script show an interactive HTML window inside its terminal: charts, forms, previews, and MCP Apps.

Remote Access

Pair a browser, connect to terminal sessions, and manage trusted devices.

Files

Open, preview, edit, save, diff, and resolve conflicts in project files.

Documentation

Browse project Markdown and MDX as a file-based documentation tree with rich editing and autosave.

Folders

Browse directories as dockable tree, list, thumbnail, or gallery tabs.

Worktrees

See every git worktree of your project with its pull request and CI checks, jump between branches, and manage worktrees from the Git panel.

Quick Push

Commit and push your changes with an AI agent that drafts a commit plan and pull request for you to approve.

Tasks

Turn Markdown checklists into progress dashboards and Kanban boards, per file or aggregated across a folder.

Shortcuts

Learn the defaults and how to customize, disable, reset, and troubleshoot shortcuts.