Maxcli banner
irons163 irons163

Maxcli

Development community

Description

macOS multi-agent CLI console for running, monitoring, and resuming Codex, Claude Code, Gemini CLI, OpenCode, and more.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

MaxCLI

macOS 上的多 agent CLI 控制台:在同一個視窗裡,同時操作、監看與恢復多個終端工作階段。

[![Latest release](https://img.shields.io/github/v/release/irons163/maxcli?display_name=tag)](https://github.com/irons163/maxcli/releases/latest) [![macOS](https://img.shields.io/badge/macOS-14%2B-111111)](https://github.com/irons163/maxcli/releases/latest)

![MaxCLI Single/Focus 工作區](docs/images/maxcli-single.png)

MaxCLI 是以 SwiftUI 製作的 macOS app。它把 Codex、Claude Code、Gemini CLI、OpenCode 等互動式工具放進真正的 PTY 終端;每個 session 都是獨立程序、工作目錄與啟動參數。你可以同時開十幾個 agent,快速知道誰正在執行、誰需要注意,以及下一步該接哪個工作。

為什麼使用 MaxCLI

  • 同時執行多個 agent,不必在終端分頁之間來回尋找。
  • 以 Focus、Grid、Active 三種工作區,在操作與總覽之間快速切換。
  • 保留各個 CLI 的原生互動介面、登入狀態與 resume 能力。
  • 聚合本機 History,從過去的對話找回 session,再綁定回目前的工作區。
  • 純本機運作;MaxCLI 不上傳 terminal 內容,也不代替各 CLI 管理帳號。

工作區

模式 適合情境
Focus 專心操作目前選取的單一終端。
Grid 同時監看多個 session;雙擊 pane 會切回該 session 的 Focus。
Active 只顯示正在執行或有活動的 session,適合等待多個 agent 回應。

Active 模式會維持穩定的工作區順序;session 的輸出與背景提醒會反映在 sidebar,不會因為每個思考中的狀態事件而持續交換位置。

Grid

![MaxCLI Grid 工作區](docs/images/maxcli-grid.png)

新增 Session

新增 session 時可以選擇 agent、工作目錄、模型或 provider、啟動參數、圖示與顏色,也可以釘選重要 session。除了內建 agent,還能使用一般 Shell 或輸入任意 Custom command。

支援的 CLI

MaxCLI 會從目前的 shell 環境尋找可執行檔;請先依照各工具的官方文件完成安裝與登入。

Agent 預設 executable
Codex codex
Claude Code claude
Gemini CLI gemini
Cursor Agent agent
GitHub Copilot CLI copilot
OpenCode opencode
Grok grok
Shell 目前使用者的 login shell
Custom 自訂命令

History 與 Resume

History 以唯讀方式聚合各工具保存在本機的 session transcript,目前支援:

  • Codex
  • Claude Code
  • Gemini CLI
  • Cursor Agent
  • GitHub Copilot CLI
  • Grok
  • OpenCode

可以從 History 找到舊 session,再從 sidebar 將它綁定到對應的 agent session。重啟時,MaxCLI 會使用該 agent 的原生 resume 參數;找不到原始紀錄時,不會影響其他來源。

下載與安裝

前往 [Latest Releases](https://github.com/irons163/maxcli/releases/latest),依照 Mac 的處理器下載:

  • Apple Silicon:M1、M2、M3、M4 等 Mac
  • Intel:Intel 處理器 Mac

開啟 DMG 後,將 `MaxCLI.app` 拖