Description
CrommaCode is a free desktop application that serves as a playful terminal for various AI coding agents, including Claude Code, Codex CLI, Gemini CLI, OpenCode, and Cursor CLI. It operates on macOS, Windows, and Linux, providing a unique environment where coding agent interactions are visualized and gamified. Instead of a simple scrolling log, CrommaCode turns each tool call into a dynamic live file tree, a clear Git history map, and an engaging game.
Read More
The application functions by running your chosen AI coding CLI within its terminal. CrommaCode then monitors every tool call through a hook, detecting reads and edits to build a real-time file tree. Git history is presented as an intuitive metro map, showing staged and unstaged changes, and allowing branch switching. A core feature is the Game View, which plays back the agent's session in five distinct modes: Westworld, Loom, Factory, Chips, and Rhythm, making the coding process interactive and observable.
CrommaCode is designed to work with existing AI coding CLIs rather than replacing them. It runs the native CLI under your own login, ensuring that your Claude or ChatGPT subscription and tokens remain secure and untouched. The Agent face feature folds the session into a conversation timeline, allowing direct interaction with the native CLI. It automatically detects CLIs, backs up user settings, and adds necessary tool hooks, with specific instructions for platforms like Codex that require reviewed hooks.
Privacy and security are central to CrommaCode's design. All code, prompts, replies, and file paths remain on your local machine, stored in `~/.cromma-bees`. Provider keys for models stay within a local gateway, and sign-in tokens are kept in the system keychain. The application is free to download and use, requiring no paid plans or accounts for its core functionality. An optional VibeLoft account allows users to participate in daily token leaderboards, called Ranks, which only upload hourly token totals and message counts, not sensitive code or prompts.
CrommaCode also introduces "Bees," which are parallel worker agents. When a task is broad, the main agent can split it and deploy these headless workers. Each bee operates in its own Git worktree and branch, using a model provider selected by the user. Anthropic Messages providers are accessed directly, while OpenAI-style providers use a local gateway to ensure keys remain secure. Nothing is merged until the user explicitly approves a bee's branch, offering controlled parallel execution for complex coding tasks.
- CategoryAI Coding Assistants
- Pricing ModelFree
- DeploymentDesktop app
- PlatformsmacOS, Windows, Linux
CrommaCode's Core Features
Desktop terminal for AI coding agents
Supports Claude Code, Codex CLI, Gemini CLI, OpenCode, Cursor CLI
Game View with five interactive modes (Westworld, Loom, Factory, Chips, Rhythm)
Live file tree visualization of agent reads and edits
Read-only Git history displayed as a metro map
Automatic CLI detection and tool hook integration
Agent face for conversation timeline interaction with native CLI
Bees: parallel worker agents in separate Git worktrees and branches
Support for Anthropic Messages and OpenAI Chat/Responses via local gateway
Local-by-default data storage for code, prompts, and sessions
Optional daily token leaderboard (Ranks) via VibeLoft account
Signed self-updates every 15 minutes
Free to download and use with no paid plans
Cross-platform compatibility: macOS, Windows, Linux
Backups of CLI settings before hook installation
How to use CrommaCode?
Download and Install: Obtain the CrommaCode desktop app for macOS, Windows, or Linux from the official website.
Launch CrommaCode: Open the application on your desktop.
Start an AI CLI: Run Claude Code, Codex CLI, Gemini CLI, or another supported coding agent CLI within the CrommaCode terminal.
Observe Agent Activity: CrommaCode automatically detects the CLI, installs hooks, and begins visualizing tool calls as a live file tree, Git map, and game.
Interact with Agent: Use the Agent face (⇧⌘J) to fold the session into a conversation timeline and type directly into the native CLI.
Utilize Bees (Optional): For wide tasks, deploy parallel worker agents ("bees") in their own Git worktrees and branches via Settings → Bees.
Monitor Progress: Watch the Game View to see your agent's session play out in various interactive modes.
Review Changes: Check the live file tree and Git tab to track reads, edits, and branch history.
CrommaCode's Use Cases
- Visualizing AI Agent Workflows
- Gamified Coding Sessions
- Parallel Task Execution
- Enhanced CLI Interaction
- Secure Local Development
- Cross-Platform AI Development
- Git History Tracking
- Monitoring Subagent Activity








