govijr/terminal-mac
Entire MacOS running in your terminal.
From the publisher
README & documentation
Source previewRead the project’s overview, installation instructions and usage examples. The original README is the source of truth.
A separate macOS desktop for computer-use agents, viewed and controlled from a terminal. iOS simulators and iPhones: see the sibling project terminal-phone. terminal-mac is an early release candidate for Apple silicon. Apple Virtualization runs a real macOS guest. A bundled helper inside that guest captures its screen and posts input events. A terminal viewer streams that screen using Kitty or iTerm2 graphics. Agent commands use the same helper without moving the physical Mac's pointer or changing its clipboard. The guest is a separate Mac: it has its own apps, files, accounts and permissions. It does not inherit your running host apps or signed-in sessions. The VM still consumes host CPU, memory and storage. The installer downloads the latest release and verifies its SHA-256 before installing. You can also extract a release ZIP and run bash install.sh from it. The installer places one launcher in /.local/bin and the bundled runtime under…
Read the full README ↗ · Preview checked 2026-11-04T13:13:51.122Z
Inside the original README — Document outline
- terminal-mac
- Requirements
- Install and run
- Use with agents
- One-time guest setup
- Build from source
- Create your first Mac
- Give an agent computer control
- Lifecycle and resources
- Isolation model
- Development and validation
Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.
Links from the README
References supplied by the publisher, not independently verified endorsements. Check the destination before downloading files or entering credentials.
Documentation belongs to its respective authors. Reported project/model license: MIT. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.
What this repository does
Entire MacOS running in your terminal.
Repository facts
- Owner
- govijr
- Primary language
- Swift
- Stars
- 941
- Forks
- 67
- Open issues + pull requests
- 3
- License
- MIT
- Archived
- No
- Default branch
- main
- Created
- 2026-11-03T03:22:56.000Z
- Last push
- 2026-11-03T12:34:41.000Z
Topics and intended use
Owner-supplied topics: cli, gui, macos, shell, swift, terminal, tui
Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.
Evaluate before installing
Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.
Source and freshness
Source: GitHub. Metadata observed 2026-11-04T12:18:51.791Z. Daily imports are snapshots, not real-time monitoring.
Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.