Jig

Jig

Terminals on a canvas.


Install and run

Jig is a local-first desktop app for Linux and macOS. Windows is out of scope for Beta v0.1.

Prerequisites

• Node.js 22 or newer
• Corepack and pnpm 11
• Rust 1.85 or newer
• Git on PATH
• Tauri 2 dependencies (WebKitGTK 4.1 on Linux, Xcode Command Line Tools on macOS)

Development

# Enable package manager and install dependencies
corepack enable
pnpm install --frozen-lockfile

# Run the desktop app
pnpm tauri dev

Build from source

# Stage daemon and build platform bundle (AppImage on Linux, .app and .dmg on macOS)
pnpm package

Builds are unsigned. macOS notarization is not configured. See [docs/install.md](docs/install.md) for platform-specific installation and verification steps.

What it is

Jig hosts coding-agent CLIs in real terminals with projects and Git worktrees. It coordinates OpenAI Codex, Claude Code, Gemini CLI, OpenCode, and custom executables in isolated PTY sessions.

**Current status:** Beta v0.1 architecture exists. The daemon, PTY management, and storage layers are operational. The IPC protocol is defined in `crates/core/src/wire`. Session creation, worktree isolation, and the terminal canvas UI are in active development. See [docs/KNOWN_ISSUES.md](docs/KNOWN_ISSUES.md) for the current domain-IPC gap and [ARCHITECTURE.md](ARCHITECTURE.md) for accepted design decisions.

This is a local-first application. No cloud account, telemetry, or vendor proxy is required. Each agent CLI keeps its own authentication.

How it works

React + xterm.js
       │ typed Tauri commands and events
       ▼
Tauri 2 desktop bridge
       │ versioned local IPC
       ▼
jig daemon
       ├── PTY session manager ── Codex / Claude / Gemini / OpenCode
       ├── Git and worktree service
       └── SQLite metadata storage

The separate daemon owns live PTYs and SQLite. Closing the desktop window does not stop active sessions. R