Back to catalog

codmate

by loocor

Pending

CodMate is a macOS SwiftUI app for managing CLI AI sessions: browse, search, organize, resume, and review work produced by Codex, Claude Code, and Gemini CLI. It focuses on speed, a compact three-column UI, and “ship it” workflows like Project Review (Git Changes) and one-click Resume/New.

588stars
35forks
Swift
Added 12/27/2025
CLI Toolsclaude-codecodex-clicodmategemini-cliswiftswiftui
Installation
# Add to your Claude Code skills
git clone https://github.com/loocor/codmate
README.md

CodMate

CodMate Screenshot

CodMate is a macOS SwiftUI app for managing CLI AI sessions: browse, search, organize, resume, and review work produced by Codex, Claude Code, and Gemini CLI.

It focuses on speed (incremental indexing + caching), a compact three-column UI, and “ship it” workflows like Project Review (Git Changes) and one-click Resume/New.

Status: macOS 13.5+, Swift 6 toolchain. Universal binary (arm64 + x86_64).

Project status (Archival note)

I plan to archive CodMate after this update. Here is the reasoning that led me to this decision:

  • Key input channels narrowed: my Claude Code account was recently suspended, which removes a major learning source for CodMate (roughly one third of the original exploration inputs). Keeping the project balanced across tools has become harder.
  • Scope drift with limited new insight: CodMate grew from a simple history viewer into a broader desktop GUI for experience, integration, and workflow consolidation. However, it has not pushed the core exploration of Agents/LLMs as much as I hoped.
  • GUI weight vs. fast‑moving cores: the underlying Agent/LLM ecosystem evolves quickly. A heavier GUI layer becomes harder to justify when CLI/TUI approaches can iterate faster with less inertia.
  • Ecosystem already covers part of the gap: Codex and Claude Code now offer VS Code/Zed extensions that share history with their CLI sessions, which increasingly addresses the original problem CodMate set out to solve.
  • Next focus is orchestration, not UI: I want to invest more in Agent orchestration and CLI‑first experimentation, potentially in a cross‑platform project (e.g., “CLIMate”), and explore open/low‑cost models (Deepseek, Kimi, GLM, etc.) more deeply.

This does not diminish what CodMate achieved. It reflects a shift in focus to where I believe the highest learning and impact now lie.

Download

Why CodMate

  • Find anything fast: a global search panel (⌘F) with scoped search + progress/cancel, plus quick list filtering.
  • Keep work organized: Projects + Tasks let you group sessions by repo and by goal, with a shareable task context file.
  • Continue instantly: Resume/New into Terminal/iTerm2/Warp (or embedded terminal in non-sandbox builds), with copyable exact commands.
  • Review & commit without leaving the app: Project Review shows diffs, staging state, and supports commit (with optional AI commit message generation).

Features (organized by value)

Organize and understand sessions across CLIs

  • Multi-source session browsing:
    • Codex: ~/.codex/sessions (.jsonl)
    • Claude Code: ~/.claude/projects (.jsonl)
    • Gemini CLI: ~/.gemini/tmp (Gemini’s session storage)
  • Sidebar navigation:
    • Projects list with counts, including “All” and an unassigned/Other bucket.
    • **Ca...