gitwtfhub

wtf is infinitty?

jasonkneen/infinitty — explained in plain English

Analysis updated 2026-05-18

65SwiftAudience · developerComplexity · 2/5Setup · easy

TL;DR

A fast, GPU-accelerated Mac terminal that exposes a clean socket and MCP interface so AI coding agents can read and control it without screen-scraping.

Mindmap

mindmap
  root((infinitty))
    What it does
      GPU-native macOS terminal
      Stays responsive under load
      Zero idle CPU and GPU use
    Tech stack
      Swift
      Metal
      MCP server
    Use cases
      Fast everyday terminal
      Agent-driven shell control
      GitHub Desktop custom shell
    Audience
      Mac developers
      AI agent builders
    Setup
      npm install
      Build from source
      macOS only

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Use it as a fast daily terminal that never freezes during large output floods.

REASON 2

Let an AI coding agent read exact command output and exit codes through the control socket instead of screen-scraping.

REASON 3

Wire it into Claude or another MCP-compatible agent via the bundled infinitty-mcp server to drive a shell directly.

What's in the stack?

SwiftMetalMCPmacOS

How it stacks up

jasonkneen/infinittystevibe/local-screen-agentiliyami/macclean
Stars656564
LanguageSwiftSwiftSwift
Setup difficultyeasyhardeasy
Complexity2/54/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires macOS 14 or later, agent features need shell integration sourced into your zsh config.

Wtf does this do

infinitty is a terminal emulator for Mac computers, built from scratch in Swift and using the GPU directly through Metal instead of wrapping a browser engine like many modern terminal apps do. The pitch is speed and responsiveness: it can print a two million line file to the screen in under a second, and the interface keeps responding to typing and scrolling even while a flood of output is coming in. When nothing is happening it uses no GPU frames and no extra CPU, since rendering pauses itself after about a second of silence. What makes this different from a typical terminal replacement is that it is explicitly designed with AI coding agents in mind, not just human typists. Instead of an agent having to read a terminal by taking screenshots or scraping raw text full of formatting codes, infinitty exposes a small local socket interface. Through that socket, a script or an agent can ask for the current visible screen, the last command's exact output and exit code, or send text and keystrokes into the terminal, all as clean structured answers rather than something that needs guesswork to parse. There is also an accompanying MCP server, letting AI tools like Claude call these same actions directly as tools, such as running a command and getting back its exit code and output in a single step. Beyond agent control, infinitty also supports multiple panes and tabs that can be listed, split, and focused programmatically, and it can be opened directly from another application, such as configuring it as the custom shell for GitHub Desktop. This project is aimed at developers, especially those building or using AI coding agents on a Mac, who want a fast terminal that agents can drive reliably. It installs through npm or by building from source with Swift, and requires a recent version of macOS to run.

Yoink these prompts

Prompt 1
Help me install infinitty and set up its MCP server for use with Claude.
Prompt 2
Explain how infinitty's control socket lets an agent read the last command's output and exit code.
Prompt 3
Show me how to configure infinitty as the custom shell in GitHub Desktop.
Prompt 4
Write a script that uses infinitty's socket commands to run a command and check its exit code.

Frequently asked questions

wtf is infinitty?

A fast, GPU-accelerated Mac terminal that exposes a clean socket and MCP interface so AI coding agents can read and control it without screen-scraping.

What language is infinitty written in?

Mainly Swift. The stack also includes Swift, Metal, MCP.

How hard is infinitty to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is infinitty for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.