# Termic

Termic is a free, open-source desktop app for running real AI coding-agent CLIs in parallel git worktrees. It spawns PTY-based tools such as Claude Code (`claude`), OpenAI Codex (`codex`), Antigravity (`agy`), GitHub Copilot (`copilot`), Grok, opencode, aider, and custom shell commands. It runs locally, has no Termic backend, supports macOS and Linux builds, and includes an optional macOS Seatbelt sandbox with a network allowlist.

Use this file as a concise index for AI assistants and documentation retrievers. For crawl metadata, use /sitemap.xml.

## Key Pages
- [Home](https://termic.dev/): Termic overview: run claude, codex, antigravity and other terminal agents in parallel git worktrees.
- [Install Termic](https://termic.dev/docs/install/): Install Termic on macOS with Homebrew or a direct DMG, and on Linux with the signed AppImage.
- [Termic comparisons](https://termic.dev/vs/): Comparison hub for Termic versus Conductor.build, AgentsRoom, Paseo, Superset and other coding-agent tools.
- [Termic alternatives guides](https://termic.dev/alternatives/): Alternative guides for developers choosing between local worktrees, visual dashboards, remote daemons, bigger platforms, schedules and sandboxing.
- [Best Conductor alternative](https://termic.dev/alternatives/conductor/): Decision guide for replacing Conductor: Termic for local AGPL worktrees and sandboxing, AgentsRoom for dashboards, Superset for a bigger platform, Paseo for remote/mobile control.
- [Termic vs Conductor.build](https://termic.dev/vs/conductor/): AGPL Conductor.build alternative for parallel coding agents in git worktrees, with Linux builds, more agent CLIs, main checkout mode and sandboxing.
- [Termic vs AgentsRoom](https://termic.dev/vs/agentsroom/): AgentsRoom alternative comparison: Termic's AGPL local worktree PTYs and sandboxing versus AgentsRoom's visual multi-project dashboard, roles, notifications and mobile companion.
- [Termic vs Paseo](https://termic.dev/vs/paseo/): Paseo alternative comparison: Termic's local desktop PTY worktrees and sandboxing versus Paseo's daemon, mobile clients, schedules and relay.
- [Termic vs Superset](https://termic.dev/vs/superset/): Superset alternative comparison: Termic's AGPL local desktop PTY worktrees and sandboxing versus Superset's source-available editor, host server, CLI, MCP, remote workspaces and automations.
- [Changelog](https://termic.dev/changelog/): Latest Termic release: v0.22.0 - Signed and notarized by Apple, adopt existing worktrees, custom work-done signals.

## Get started
- [What is Termic?](https://termic.dev/docs/introduction/): Termic is a free, open-source desktop app that runs claude, codex, antigravity and any terminal agent in parallel git worktrees, on the Claude Pro / Max plan you already pay for.
- [Install Termic](https://termic.dev/docs/install/): Install Termic on macOS with Homebrew or a direct .dmg, on Linux with the signed AppImage, or build from source on any platform. Includes the in-app self-updater.
- [Your first task](https://termic.dev/docs/quickstart/): A five-minute walkthrough: add a project, spawn your first agent in a git worktree or the main checkout, run your dev server, review the diff, and ship the change.
- [Migrating from Conductor](https://termic.dev/docs/migrating-from-conductor/): A concept-by-concept map from Conductor.build to Termic: what's the same, what's named differently, what Termic does better, and the one config alias that makes the move painless.

## Concepts
- [Tasks & worktrees](https://termic.dev/docs/tasks/): How Termic models projects, tasks and git worktrees, and when to use an isolated worktree versus attaching an agent straight to your main checkout.
- [Multi-repo tasks](https://termic.dev/docs/multi-repo-tasks/): Group your backend, frontend and infra repos under a single Termic task with a shared CLAUDE.md, per-member ports and one aggregated diff, so an agent can work across all of them at once.
- [Running agents in parallel](https://termic.dev/docs/parallel-agents/): Run several coding agents at once in Termic: many worktrees on many branches, or many agents against one branch in tabs. How to keep track of them and when parallelism actually pays off.
- [Agents & the registry](https://termic.dev/docs/agents/): Termic ships claude, codex, antigravity, copilot, grok and opencode as built-in agents, and lets you register any PTY-based CLI (aider, ollama, a shell script) in about thirty seconds.
- [Work-done detection & notifications](https://termic.dev/docs/work-done-and-notifications/): How Termic knows when an agent has finished a turn or is blocked on input, the blue dot and attention bell, and the optional desktop notifications that route you to the right task.

## Sandbox & security
- [The per-task sandbox](https://termic.dev/docs/sandbox/): Termic's optional macOS sandbox cages each agent with a Seatbelt filesystem profile and a network allowlist, so it can run unattended without reaching your secrets or the open internet. A Monitoring mode lets you watch every access first and build the allowlist before you enforce it, and a filesystem-only mode isolates the disk while leaving the network open.
- [The network allowlist](https://termic.dev/docs/sandbox-network/): How Termic's sandbox confines an agent's network access to a per-task hostname allowlist via an in-process proxy, what's allowed by default, how to add hosts, and how to debug a blocked request.
- [Privacy](https://termic.dev/docs/privacy/): Termic is a local desktop app with no backend. Your prompts and code go from the terminal to the CLI to the vendor, and nowhere through Termic. Here's exactly what that means.

## Working in Termic
- [The terminal](https://termic.dev/docs/terminal/): Termic's terminals are real PTYs rendered with xterm.js and WebGL: OSC 52 clipboard, inline images and Sixel, Unicode 11 widths, find-in-terminal, drag-and-drop file paths, and configurable scrollback.
- [File finder & search](https://termic.dev/docs/file-search/): Termic's Cmd+P fuzzy file finder (backed by git ls-files) and Shift+Cmd+F find-in-files (backed by git grep, gitignore-aware, streaming) make navigating and searching a repo fast even on huge codebases.
- [Spotlight](https://termic.dev/docs/spotlight/): Spotlight syncs one task's changes into your main checkout so you can run and test your whole dev stack against it, without ever writing a commit onto your branch. Safer than Conductor's checkpoints.
- [Broadcast](https://termic.dev/docs/broadcast/): Broadcast sends the same prompt to every agent in a task, or to the main agent of every task in a project, so you can fan one message out to many agents at once.
- [Scheduled messages & Ralph-style loops](https://termic.dev/docs/message-queue/): Queue turn-scheduled follow-up messages for a coding agent, repeat prompts, and run Ralph-style keep-going loops that advance each time the agent finishes.
- [Prompt library](https://termic.dev/docs/prompts/): Save the prompts you send over and over, fire them from one menu, and pick where each one runs: an existing agent or a fresh one. Termic ships a diff-aware starter set you can edit or replace.
- [AI code review](https://termic.dev/docs/code-review/): Have one agent review another's work: Termic's review dialog spawns a fresh agent, hands it the diff and a review prompt, and streams the review right in the task.
- [Scripts: setup, run & preview](https://termic.dev/docs/scripts-and-run/): Configure a setup script, a run script and a preview URL per project so every task can install dependencies, start a dev server, and open in the browser. Includes the full variable reference.
- [Keyboard shortcuts](https://termic.dev/docs/keyboard-shortcuts/): The full keyboard reference for Termic: switching tabs and tasks, opening the file finder and find-in-files, splitting shells, broadcasting, and searching a terminal.
- [Themes & appearance](https://termic.dev/docs/themes/): Termic ships seven UI themes and eight syntax themes, configurable fonts, an adjustable terminal font weight, and tunable scrollback, all in the Appearance settings.

## Git / Source Control
- [Editor & diff viewer](https://termic.dev/docs/editor-and-diff/): Termic has a built-in CodeMirror editor and a syntax-highlighted diff view against HEAD, side-by-side or unified, plus Send to main to land a worktree's changes in your parent checkout.
- [Inline comments](https://termic.dev/docs/inline-comments/): Leave GitHub-style inline comments on a diff and send them back to the agent as one batch of feedback: select lines, write a note, review the drafts, and hand them off.
- [Git: staging & commits](https://termic.dev/docs/git/): The Git tab is a Fork-style staging area built into Termic: stage and unstage files, write a commit, and push, all without leaving the task. Tree, list and combined views, per-repo sub-tabs for multi-repo tasks, and discard with a confirm.

## Configuration
- [.termic.yaml](https://termic.dev/docs/termic-yaml/): Commit a .termic.yaml file to your repo so scripts, the preview URL, sandbox allowlist and files-to-copy travel with the project, and teammates inherit the same Termic setup without redoing it.
- [Settings reference](https://termic.dev/docs/settings/): A tour of Termic's settings: Appearance (themes, fonts, scrollback), General (notifications, sandbox defaults), Agents (the CLI registry), Shortcuts, and Repository (scripts, preview, sandbox, Spotlight).

## Reference
- [Architecture & data](https://termic.dev/docs/architecture/): What Termic is built on (Tauri 2, Rust, React, xterm.js with WebGL, CodeMirror, portable-pty) and exactly where it stores your projects, tasks and settings on disk.
- [Roadmap](https://termic.dev/docs/roadmap/): What's coming to Termic: GitHub and Linear issue integration, context menus and open-in actions, sandbox parity on Linux and Windows, Windows prebuilts, split panes, faster search, and raw TCP support in the sandbox.

## Troubleshooting
- [Frequently asked questions](https://termic.dev/docs/faq/): Answers to the common questions about Termic: subscription quota, how it differs from Conductor, privacy, the sandbox, supported platforms, and bringing your own agent.
- [Troubleshooting common issues](https://termic.dev/docs/troubleshooting/): Fixes for the things that occasionally go wrong in Termic: a blank terminal, an npm install failing inside the sandbox, the window opening tiny, and thin fonts on Linux.

## Stable Facts
- License: AGPL-3.0.
- Repository: https://github.com/simion/termic.
- Built-in agents: claude, codex, antigravity, copilot, grok, opencode.
- Core workflow: one task per git worktree, with parallel agents, diffs, staging, run scripts and previews.
- Sandbox: macOS Seatbelt filesystem profile plus in-process HTTPS CONNECT proxy with hostname allowlist.
- Platforms: macOS and Linux release builds; Windows builds from source today.