Skip to content
Back to search

Termos

Minimal terminal multiplexer for macOS with projects, freezable terminals and a Claude Code MCP server

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/surzhikov--termos/badge.svg)](/listings/surzhikov--termos)

HTML

<a href="/listings/surzhikov--termos"><img src="/api/listings/surzhikov--termos/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 93 lines
  1. # Termos
  2. A minimal terminal multiplexer for macOS written in Swift (AppKit + a SwiftUI sidebar).
  3. Terminal emulation is provided by [SwiftTerm](https://github.com/migueldeicaza/SwiftTerm) v1.11.2 (MIT),
  4. vendored in `Vendor/SwiftTerm` (no dev dependencies; the scroller is switched to overlay style).
  5. ## Build
  6. ./build.sh # → build/Termos.app
  7. ./build.sh --install # also copies it to /Applications
  8. open build/Termos.app
  9. Only the Command Line Tools are required (no Xcode).
  10. ## Projects
  11. Termos works in terms of **projects** (like VS Code): a project is a `.termos` file that holds
  12. all workspaces with their terminals, split layout, colors, startup commands and frozen state.
  13. - **File → New Project…** (⇧⌘N) — choose where to save, get a workspace with one terminal.
  14. - **File → Open Project…** (⌘O) or double-click a `.termos` file in Finder.
  15. - The project file is updated automatically on every change, so after a reboot just open it
  16. and everything comes back exactly as it was — including frozen terminals.
  17. ### Frozen terminals
  18. Any terminal can be **frozen** (right-click → Freeze Terminal, or ⇧⌘F): its shell and everything
  19. running in it is stopped to free memory, and the pane turns into a gray block with the terminal's
  20. name and a **Restore** button. Restore starts the shell again and re-runs the terminal's
  21. **Startup Command** (e.g. `claude --resume <session>`), so long-running sessions are one click away.
  22. ### Multiple windows
  23. **File → New Window** (⌘N) opens another Termos process with its own project. Each window can
  24. have its own project open. Terminals pass their window's id down to the programs they run, so
  25. Claude Code started inside a pane always controls the window it lives in.
  26. ## Shortcuts
  27. | Action | Keys |
  28. |---|---|
  29. | New / open project | ⇧⌘N / ⌘O |
  30. | New window | ⌘N |
  31. | New workspace | ⌘T |
  32. | Split right / down | ⌘D / ⇧⌘D |
  33. | Freeze terminal | ⇧⌘F |
  34. | Close terminal / workspace | ⌘W / ⇧⌘W |
  35. | Move focus | ⌥⌘ + arrows |
  36. | Swap with neighbor | ⌃⌘ + arrows |
  37. | Next / previous terminal | ⌘] / ⌘[ |
  38. | Workspace 1…9 | ⌘1…⌘9 |
  39. | Next / previous workspace | ⇧⌘] / ⇧⌘[ |
  40. | Zoom terminal to the whole workspace | ⇧⌘↩ or double-click the header |
  41. | Equalize sizes | ⌃⌘= or double-click a divider |
  42. | Custom background color | ⇧⌘K |
  43. | Rename workspace / terminal | ⇧⌘R / ⌥⌘R |
  44. | Toggle sidebar | ⌃⌘S |
  45. | Font bigger / smaller / reset | ⌘= / ⌘- / ⌘0 |
  46. | Full screen | ⌃⌘F |
  47. Color scheme, border label and rename are available from the right-click menu on a terminal,
  48. its header or its sidebar row, and from the Terminal menu.
  49. ## Drag & drop
  50. Drop files or folders onto a terminal to insert their shell-escaped paths (like Terminal.app).
  51. Image data without a file (e.g. dragged from a browser) is saved to
  52. `~/Library/Caches/Termos/Drops/` and its path is inserted. Text is sent as a bracketed paste,
  53. so tools like Claude Code pick up dropped image paths as image attachments.
  54. Terminals can be rearranged by dragging their headers — into another split position,
  55. another workspace in the sidebar, or onto “New Workspace” to move one out.
  56. ## Claude Code (MCP)
  57. `Termos --mcp` is a stdio MCP server. It talks to the running app over per-user Unix sockets
  58. (mode 0600) and launches Termos if it isn't running. Register it once:
  59. claude mcp add -s user termos -- /Applications/Termos.app/Contents/MacOS/Termos --mcp
  60. With several Termos windows open, the server picks the window automatically when Claude Code is
  61. started inside one of its terminals, and otherwise lists the running windows with their
  62. workspaces and asks you to pick (or set `TERMOS_INSTANCE_ID`).
  63. Tools: `termos_list`, `termos_new_project`, `termos_open_session`, `termos_create_workspace`
  64. (grid of columns × rows, one entry per terminal with name / cwd / command / theme / label),
  65. `termos_add_terminal`, `termos_run`, `termos_read`, `termos_update_terminal`,
  66. `termos_update_workspace`, `termos_focus` (with `restore: true` for frozen terminals),
  67. `termos_freeze_terminal`, `termos_restore_terminal`, `termos_close_terminal`,
  68. `termos_close_workspace` (both refuse while a program runs unless `force`), `termos_save_layout`,
  69. `termos_open_layout`.
  70. Example prompt: *"Create a workspace with a 3×2 grid and a terminal for each client in ~/clients,
  71. named after the client."*

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.