Mantel

Product Introduction

1. Definition: Mantel is a lightweight, native macOS terminal application built on top of Apple's default Terminal.app. It is a visual enhancement layer designed for the "Agentic CLI Era," adding dynamic, project-aware theming and identity management to the standard terminal experience.
2. Core Value Proposition: Mantel exists to eliminate terminal window confusion for developers and professionals running multiple concurrent sessions, such as AI coding agents (Claude Code), dev servers, and test suites across different projects. Its core value is visual project differentiation to reduce cognitive load, prevent context-switching errors, and increase focus during multi-project workflows.

Main Features

1. Dynamic Per-Project Identity: Each terminal window and tab automatically adopts a unique visual identity based on the working directory. This includes a distinct color theme, custom name, and dynamic Dock icon. The technology works by running mantel init within a project folder, which creates a .mantel/ directory containing a config.json file and an optional icon, allowing for team-wide or personal configuration.
2. Integrated Task & Notification System: Mantel provides native macOS notifications, Dock badges, and bounce animations when background shell tasks (like dev servers or long-running scripts) complete. This feature eliminates the need to manually check every terminal window for task completion, a common pain point in multi-window environments.
3. Context-Aware Workflow Enhancements: The app integrates several productivity tools directly into the terminal interface. It automatically detects and displays the current Git branch, provides one-click links to the GitHub repository, and shows a menu of npm/yarn scripts from package.json files. It also adds Finder Quick Actions to open any folder directly in a new Mantel tab or window.

Problems Solved

1. Pain Point: Terminal Window Indistinguishability. The primary problem is that all default terminal windows appear identical (black background, generic Terminal icon), forcing users to rely on memory or window titles to identify projects, leading to mistakes, lost output, and constant mental reorientation.
2. Target Audience: Non-power-user terminal professionals. This includes product managers using Claude Code, founders and indie hackers building MVPs, full-stack developers managing multiple microservices or client projects, and anyone whose workflow has shifted to the terminal due to AI coding agents but who does not wish to configure complex tools like tmux or iTerm2 profiles.
3. Use Cases: Running parallel AI coding agent sessions (e.g., Claude Code on different projects); managing multiple local development servers for a frontend and backend; monitoring background test suites or build processes across different repositories; switching contexts rapidly between different client or freelance projects throughout the day.

Unique Advantages

1. Differentiation: Unlike feature-rich terminals like iTerm2, Warp, or Ghostty, Mantel is not a full terminal emulator replacement. It is a lightweight wrapper that adds a single, focused layer of intelligence—project identity—on top of the reliable, familiar macOS Terminal. This results in zero learning curve for shell usage, contrasting with the complexity and configuration overhead of power-user terminals.
2. Key Innovation: The automatic, directory-based contextual theming engine. While other terminals offer static profiles or themes, Mantel's innovation is dynamically applying a unique visual identity (color, icon, name) based on the file system path. This happens in real-time without user intervention, and the configuration is project-based (via .mantel/ folder), making it portable and shareable across teams.

Frequently Asked Questions (FAQ)

1. Is Mantel a full terminal replacement like iTerm2? No, Mantel is a lightweight application that runs on top of your existing macOS Terminal and default shell (zsh, bash, fish). It does not replace the terminal engine but enhances it with visual project identity, preserving all your existing configurations, aliases, and shell behavior.
2. How does Mantel work with AI coding agents like Claude Code? Mantel is the ideal visual companion for Claude Code and other terminal-based AI agents. By giving each project a unique color and icon, you can run multiple Claude Code sessions in parallel across different projects without confusing which terminal window belongs to which codebase, significantly reducing agent management overhead.
3. Can I use Mantel for SSH or remote development sessions? Yes, Mantel automatically detects SSH connections and assigns a distinct visual profile to remote sessions, displaying the user@hostname in the info bar. This provides immediate visual recognition for local versus remote terminal windows.
4. What is the pricing model for Mantel? Mantel is a one-time purchase of $14.99 with no subscription fees. It includes a full-featured 14-day free trial with no credit card required. The one-time fee grants a permanent license for all current and future 1.x version features.
5. Where is the project configuration stored, and is it shareable? Project-specific configurations (color, icon, name) are stored in a .mantel/ folder within the project's root directory. This folder contains a config.json file and an optional icon, which can be committed to Git so that all team members share the same visual project identity.