Terminay Documentation
Choose a topic to learn how to use Terminay. These pages focus on the app itself: workspaces, the Home dashboard, workflows, automations, bots, agents, Pixel, files, project documentation, folders, tasks, macros, recordings, settings, remote access, and shortcuts.
Installation
Install the desktop app on macOS, Windows, or Linux, or run Terminay Server on a Linux host or in Docker.
Workspace
Use project tabs, folders, docked terminals, split panes, popouts, the status bar, and the project sidebar.
Home
See every project, tab, agent, bot, automation, and recording in one place, as a list, a board, or project cards.
Command Bar
Search commands and macros from one keyboard-first launcher.
Macros
Write reusable terminal scripts with fields and categories, and run them from the Command Bar.
Workflows
Give the agent in a terminal a checklist to work through, and watch the progress of each step beside the terminal.
Automations
Run a command, a macro, or some text on a schedule or when an agent, terminal, project, or device event happens.
Bots
Run long-lived Claude Code and Codex bots in their own containers, with a desktop, memories, and triggers that wake them.
Recordings
Capture terminal sessions as local asciicast v3 files, then replay, search, reveal, or delete them from the timeline.
Settings
One window for appearance, shells, remote access, macros, workflows, extensions, shortcuts, and updates.
Agents
Follow coding-agent activity, open the right terminal, and see when an agent is working, waiting, or done.
Pixel
Turn on Pixel, the status-bar companion, and chat with Claude Code or Codex about every terminal on the server.
Notifications
See when an agent finishes or needs you, on the desktop and as a banner on your phone, cleared on every device at once.
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 each worktree from its folder.
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.