crystl

Product Introduction

1. Definition: crystl is a specialized macOS terminal application and multitasking environment built specifically for running AI coding agents, including Claude Code, Codex, Antigravity CLI, Kimi Code, opencode, aider, goose, and Ollama. Functioning as a high-performance terminal emulator powered by Metal rendering, it structures command-line AI interactions into manageable data sessions.
2. Core Value Proposition: crystl exists to eliminate the cognitive overhead and workflow friction of managing multiple concurrent AI coding agents across disparate projects. By integrating parallel git worktrees, persistent markdown-based project contexts, interactive floating approval cards, and multi-agent orchestration (via crystl guild), it provides a centralized control hub for AI-assisted software development.

Main Features

1. Parallel Git Worktrees & Gems/Shards: crystl organizes user workspaces into "gems" (projects) and individual sessions into "shards" (terminal instances). When launching multiple agents within the same project, crystl automatically isolates each shard into its own distinct git worktree and branch. To conserve system resources on macOS, off-screen shards throttle their render workloads to near-zero.
2. Cavrn Terminal Engine & GPU Rendering: Built on the Cavrn terminal architecture, crystl captures terminal output as structured data rather than raw text scrollback. Every turn, tool call, table, and result is recorded as agent-readable metadata using GPU-accelerated Metal rendering, allowing orchestrator agents to programmatically parse and monitor sub-agent sessions.
3. Cross-Platform Floating Cards & Mobile Companion: When agents require user input, permissions, or approvals, crystl surfaces color-coded glass notification cards directly on the desktop interface. Additionally, the companion app for iPhone (integrated via crystl guild and encrypted relays) pushes these approval prompts and monitoring panes to mobile devices over Wi-Fi or cellular networks.

Problems Solved

1. Pain Point: Developers running multiple AI coding agents simultaneously face severe context switching, visual fatigue from scrolling raw terminal histories, fragmented project configurations (such as drifting CLAUDE.md files), and stalled worker agents that go unnoticed during long execution cycles.
2. Target Audience: AI-forward software engineers, full-stack developers, DevOps professionals, and technical project managers who utilize command-line AI coding assistants (like Claude Code) at scale across multiple concurrent repositories.
3. Use Cases: Managing a multi-tier agent hierarchy where a master orchestrator spawns sub-agents to handle parallel bug fixes across different microservices; executing long-running background documentation or refactoring tasks via automated schedules; and steering agent approvals remotely from an iPhone while away from the development workstation.

Unique Advantages

1. Strengths & Limitations (Pros & Cons):
   • Pros: Exceptional performance via Metal GPU rendering; seamless support for multiple CLI agents (Claude Code, Codex, Ollama, etc.); robust multi-agent orchestration via "crystl quest"; zero vendor lock-in because all context and task lists (WORKBENCH.md) reside as plain markdown files inside the local project folder; native iOS remote monitoring.
   • Cons: Deepest interactive integrations (such as hook-based approval cards) are optimized primarily for Claude Code and Codex, with lesser hook support for alternative CLIs like Antigravity; platform-restricted to macOS for the desktop terminal client; advanced multi-tier orchestration requires the paid "guild" tier.
2. Key Alternatives & Differentiation: Unlike running native Terminal.app or iTerm2—which lack awareness of AI sessions, structured data terminals, and cross-project task syncing—crystl provides native awareness of agent lifecycles. Compared to basic web-based AI IDE extensions, crystl operates directly on full native CLI agents within real terminal environments, preserving complete developer toolchains while adding state management, token tracking, and worktree isolation.

Frequently Asked Questions (FAQ)

1. What AI coding agents are compatible with crystl? crystl runs any command-line interface (CLI) coding agent, featuring deep hook integrations for Claude Code and Codex, alongside native support for Antigravity CLI, Kimi Code, opencode, aider, goose, and local open-source models run via Ollama.
2. Does crystl lock my project configurations into a proprietary format? No. All project configurations, task trackers (WORKBENCH.md), and agent instructions are stored as plain markdown files directly within your local project folder, making them fully version-controlled with Git and portable across developer environments.
3. How does crystl handle system resource usage when running multiple AI agents? crystl isolates each parallel agent session into its own git worktree and branch, while automatically throttling off-screen shard rendering workloads to near-zero, ensuring that scaling from a few agents to a dozen remains lightweight on macOS hardware.
4. Can I monitor and approve agent requests when I am away from my Mac? Yes. The companion app for iPhone—available on the App Store—connects to your roster via Wi-Fi or encrypted relay on crystl guild, allowing you to review approval prompts, answer agent questions, and spawn new tasks directly from your mobile device.