Skip to content

MacAIterm 0.1.0

Latest
Latest

Choose a tag to compare

View all tags
@NeuronLinkX NeuronLinkX released this 05 Oct 11:47
· 2 commits to main since this release
v0.1.0
cc7ab35

First public release of MacAIterm, a macOS terminal with a built-in AI agent, SSH server monitoring and file transfer. The app was formerly named AI Terminal.

Download

MacAIterm-0.1.0-arm64.dmg for macOS 13 or later on Apple silicon.

SHA-256: c24c4d70ef4b99d0ea57ec02cb6f6444e7e8c822864a6b454ad1838794c96d40

Install

  1. Open the .dmg and drag MacAIterm to Applications.
  2. The app is signed with a self-signed certificate and is not notarized. On the first launch, right-click the app and choose Open. If macOS still blocks it, use System Settings → Privacy & Security → Open Anyway.
  3. No model is bundled. Set up Ollama, an OpenAI-compatible server or Codex CLI before the first request.
  4. To reach servers on your home or office network, macOS must allow MacAIterm to use the local network. It asks the first time the app connects to such a server (click Allow), or you can trigger the question from Settings → SSH · Remote → Local network access → Ask for access. If you chose Don't Allow, switch it on in System Settings → Privacy & Security → Local Network.

macOS may ask about the "MacAIterm Safe Storage" Keychain item after an install or update. Enter your password yourself and choose Always Allow, or deny it if you do not save API keys.

Highlights

  • An agent that works in your shell session, with undoable diffs, plan mode and approvals for risky commands.
  • Local models through Ollama, OpenAI-compatible servers, the OpenAI API and Codex CLI.
  • SSH: the agent can work on a server, a CPU / memory / GPU / disk strip, a session manager and file trees with SHA-256 verified copies.
  • A built-in editor for ~/.ssh/config: syntax check with the real ssh -G, line-numbered errors, backups of the previous content and a conflict check.
  • Remote screen (VNC): show a server's VNC desktop inside the window. The picture travels only through the tab's SSH connection, no port is opened on your Mac, and the VNC password is never stored. The AI chat does not see or operate the screen: requests run as shell commands over SSH.
  • Connection attempts give up after 10 seconds, and when this Mac is on a different network than the server the app says so.
  • A button in the top bar (Shift+Cmd+A) hides and shows the AI chat and its input bar together, so the terminal can use the whole window.
  • Korean and English interface.

Known limits

  • Not notarized (self-signed certificate).
  • If macOS never shows the local network question and ssh to a server on your network says No route to host inside the app, start the app once from Terminal with /Applications/MacAIterm.app/Contents/MacOS/MacAIterm (it then uses Terminal's permission).
  • No Intel build is available.
  • SSH was exercised against a local test server, an Ubuntu VM and one NVIDIA DGX Spark. Servers that only allow password login were not tested.
  • The remote screen was exercised against a test VNC server and a TigerVNC server on an Ubuntu VM. Other VNC servers, slow connections, sound, file transfer and multi-monitor selection are not covered.

See CHANGELOG.md and PRIVACY.md.

Assets 3
Loading