CodMate is a macOS SwiftUI application for managing CLI AI sessions from Codex, Claude Code, and Gemini CLI. It addresses the need for organizing, searching, resuming, and reviewing AI-generated work with a speed-focused, compact three-column UI. The app benefits users by enabling efficient workflows for code review, session resumption, and managing AI output across projects.

How It Works

Built with SwiftUI, CodMate prioritizes speed via incremental indexing and caching. It aggregates sessions from multiple CLI tools into a unified interface. Key features include a global search panel, a Projects and Tasks system for organization, and seamless session resumption into various terminals or an embedded option. A notable feature is the integrated Project Review mode, which displays Git diffs, supports staging/committing, and can generate AI-powered commit messages.

Quick Start & Requirements

Download the latest release DMG from GitHub Releases. Requires macOS 13.5+, Swift 6 toolchain, Xcode Command Line Tools, and the target CLIs (Codex, Claude, Gemini) on the system PATH. Building from source is supported via make commands (e.g., make build, make dmg).

Highlighted Details

• Performance: Utilizes incremental indexing, caching, memory-mapped reads, and chunked full-text search for speed.
• Organization: Sessions are managed via Projects and Tasks, with shareable task context files.
• Integrated Git Workflow: Project Review mode offers Git diffs, staging, committing, and optional AI commit message generation.
• Multi-Terminal Support: Resumes sessions in Terminal.app, iTerm2, Warp, or an embedded terminal, with command copying.

Maintenance & Community

The provided README does not detail specific contributors, sponsorships, or community channels.

Licensing & Compatibility

Distributed under the Apache License 2.0, which is permissive for commercial use and integration.

Limitations & Caveats

This application is macOS-exclusive. The README focuses on development considerations rather than explicit user-facing limitations or known bugs. A Swift 6 toolchain is a prerequisite for building.