codmate

🥈Silver

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.

653340Updated 2w ago

Intermediate30min to implementautomation

Saves ~60 min per use

Quick InstallView Source

git clone https://github.com/loocor/codmate.git

Works with:

Claude

Overview

About This Skill

https://github.com/loocor/CodMate

How to Use

[{"step":"Install and launch CodMate on macOS. Ensure your CLI AI tools (Codex, Claude Code, or Gemini CLI) are installed and authenticated.","tip":"Use `brew install --cask codmate` for installation. Verify CLI tools with `codex --version` or `claude --version`."},{"step":"Start a new session or resume an existing one. Use the search bar to filter sessions by project, file, or keywords.","tip":"Press `Cmd+Shift+O` to open the session browser. Use `Cmd+F` to search within a session."},{"step":"Review changes in the three-column UI. The left column shows the file tree, the middle column displays the diff, and the right column lists key changes.","tip":"Hover over diffs to see inline comments or suggestions. Use `Cmd+Shift+R` to mark a session as 'Reviewed'."},{"step":"Take action on the session. Use 'Ship It' workflows to generate a summary, create a PR, or export notes to your project management tool.","tip":"For Git-integrated projects, use `Cmd+Shift+G` to review changes before committing. Export summaries with `Cmd+Shift+E` to Notion or Jira."},{"step":"Close the session or save it for later. CodMate automatically archives sessions for future reference.","tip":"Use `Cmd+S` to save a session without closing. Sessions are stored in `~/Library/Application Support/CodMate/sessions/`."}]

Use Cases

Quickly search and filter through AI session history to find relevant outputs.

Organize AI sessions into projects and tasks for better management and collaboration.

Resume previous CLI sessions instantly in your preferred terminal application.

Review Git changes and generate AI-assisted commit messages directly within the app.

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/loocor/codmate

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Use CodMate to [ACTION] for [PROJECT/PURPOSE]. For example: 'Use CodMate to resume the last CLI AI session for the [PROJECT_NAME] repository and review the changes made to the [FILE_PATH] file.'

Example Output

### CodMate Session Review: E-commerce API Refactor

**Session ID:** `2024-05-15_14-30-47_claude_code`
**Project:** `acme-ecommerce-api`
**Last Modified:** 2 hours ago

#### Changes Reviewed:
1. **`src/controllers/orderController.js`**
   - Added `cancelOrder` endpoint with transaction support.
   - Refactored `createOrder` to validate inventory in real-time.
   - **Lines 45-60:** New validation logic for stock levels.

2. **`src/models/Order.js`**
   - Added `status` enum: `PENDING`, `PROCESSING`, `CANCELLED`, `SHIPPED`.
   - **Line 12:** Default status set to `PENDING`.

3. **`tests/order.test.js`**
   - Added test case for `cancelOrder` endpoint.
   - **Lines 88-102:** Mocked database calls for edge cases.

#### Key Findings:
- **Critical:** The `cancelOrder` endpoint lacks rate-limiting (security risk).
- **Improvement:** Logging for `createOrder` validation failures is too verbose.
- **Ship-Ready:** All changes are tested and pass CI/CD pipeline.

#### Next Steps:
- [ ] Add rate-limiting middleware to `cancelOrder`.
- [ ] Simplify validation error logs in `orderController.js`.
- [ ] Merge PR #42 after review.

---
*Reviewed in CodMate v1.2.1 | Session Duration: 47 minutes*