{
  "schemaVersion": 2,
  "name": "Owlbay Mac Setup",
  "platform": "macos",
  "updated": "2026-10-03",
  "source": "https://mac-terminal-notes.owlbay.chatgpt.site/",
  "notes": {
    "zh": "命令为页面原样记录，执行前请对照官网确认；软件清单是候选，不建议全部安装。",
    "en": "Commands are recorded as published; check each official site before running. The software list is a set of candidates, not an install-all list."
  },
  "regions": {
    "official": {
      "zh": "国际 / 官方源",
      "en": "International / Official"
    },
    "cn": {
      "zh": "中国大陆镜像",
      "en": "Mainland China mirror"
    }
  },
  "bootstrap": [
    {
      "id": "homebrew",
      "name": "Homebrew",
      "why": {
        "zh": "先确认包管理器可用，后续工具才有统一、可检查的安装入口。",
        "en": "Verify the package manager first so later tools have one consistent, inspectable install path."
      },
      "run": {
        "official": "xcode-select --install\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"",
        "cn": "xcode-select --install\nexport HOMEBREW_BREW_GIT_REMOTE=\"https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git\"\nexport HOMEBREW_API_DOMAIN=\"https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api\"\nexport HOMEBREW_BOTTLE_DOMAIN=\"https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles\"\ngit clone --depth=1 https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install.git brew-install\n/bin/bash brew-install/install.sh"
      },
      "verify": "brew --version",
      "docs": {
        "official": "https://docs.brew.sh/Installation",
        "cn": "https://mirrors.tuna.tsinghua.edu.cn/help/homebrew/"
      }
    },
    {
      "id": "mise",
      "name": "Mise",
      "why": {
        "zh": "Mise 官方推荐用 mise.run 安装独立版本（装到 ~/.local/bin，可用 mise self-update 更新），装好后在 ~/.zshrc 里启用；中国大陆访问 GitHub 较慢时，可改用 Homebrew 镜像安装。",
        "en": "Mise recommends its standalone installer from mise.run (installs to ~/.local/bin and updates with mise self-update); activate it in ~/.zshrc. If GitHub is slow from mainland China, install it from the Homebrew mirror instead."
      },
      "run": {
        "official": "curl https://mise.run | sh\necho 'eval \"$(~/.local/bin/mise activate zsh)\"' >> ~/.zshrc\nexec zsh",
        "cn": "HOMEBREW_API_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api \\\nHOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles \\\nbrew install mise"
      },
      "verify": "mise --version",
      "docs": "https://mise.jdx.dev/installing-mise.html"
    },
    {
      "id": "node",
      "name": "Node.js",
      "why": {
        "zh": "通过 Mise 安装 Node.js，不要把系统自带环境和 Agent CLI 的运行时混在一起。",
        "en": "Install Node.js through Mise instead of mixing agent runtimes with the system environment."
      },
      "run": "mise use -g node@26",
      "verify": "node --version\nnpm --version"
    },
    {
      "id": "claude-code",
      "name": "Claude Code",
      "why": {
        "zh": "通过 Mise 管理的 npm 安装 Claude Code；不要使用 sudo，并在首次启动时按官方流程登录。",
        "en": "Install Claude Code with Mise-managed npm. Do not use sudo; follow the official sign-in flow on first launch."
      },
      "run": "npm install -g @anthropic-ai/claude-code",
      "verify": "claude doctor\nclaude"
    }
  ],
  "maintenance": "brew update\nbrew doctor\nbrew search mise\nbrew info mise",
  "runtimes": [
    {
      "tool": "node",
      "name": "Node.js",
      "use": "JavaScript / TypeScript",
      "versions": [
        "26",
        "24"
      ],
      "note": {
        "zh": "26 / 24 LTS",
        "en": "26 / 24 LTS"
      }
    },
    {
      "tool": "python",
      "name": "Python",
      "use": "Python / Scripts",
      "versions": [
        "3.14",
        "3.13"
      ],
      "note": "3.14 / 3.13"
    },
    {
      "tool": "go",
      "name": "Go",
      "use": "Go toolchain",
      "versions": [
        "1.27"
      ],
      "note": "1.27"
    },
    {
      "tool": "java",
      "name": "Java",
      "use": "JVM / Java",
      "versions": [
        "corretto-25"
      ],
      "note": {
        "zh": "25 LTS（Amazon Corretto）",
        "en": "25 LTS (Amazon Corretto)"
      }
    },
    {
      "tool": "bun",
      "name": "Bun",
      "use": "JS runtime / Package manager",
      "versions": [
        "latest"
      ],
      "note": {
        "zh": "最新稳定版",
        "en": "Latest stable"
      }
    },
    {
      "tool": "pnpm",
      "name": "pnpm",
      "use": "Node package manager",
      "versions": [
        "latest"
      ],
      "note": {
        "zh": "最新稳定版",
        "en": "Latest stable"
      }
    },
    {
      "tool": "rust",
      "name": "Rust",
      "use": "Rust toolchain",
      "versions": [
        "latest"
      ],
      "note": {
        "zh": "最新稳定版",
        "en": "Latest stable"
      }
    }
  ],
  "mirrors": [
    {
      "name": "Node.js + npm",
      "how": {
        "zh": "同时设置 Mise 的 Node.js 下载地址与 npm 包注册表。",
        "en": "Sets both Mise's Node.js download mirror and the npm package registry."
      },
      "official": "mise settings unset node.mirror_url\nnpm config set registry https://registry.npmjs.org/",
      "cn": "mise settings node.mirror_url https://npmmirror.com/mirrors/node/\nnpm config set registry https://registry.npmmirror.com/",
      "docs": "https://mise.jdx.dev/lang/node.html"
    },
    {
      "name": "Python + pip",
      "how": {
        "zh": "通过 pip 用户配置切换 Python 包索引。",
        "en": "Switches the Python package index through pip's user configuration."
      },
      "official": "python -m pip config set global.index-url https://pypi.org/simple",
      "cn": "python -m pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple",
      "docs": "https://pip.pypa.io/en/stable/cli/pip_config/"
    },
    {
      "name": "Go Modules",
      "how": {
        "zh": "使用 go env 持久化模块代理，保留 direct 回退。",
        "en": "Persists the module proxy with go env while retaining a direct fallback."
      },
      "official": "go env -w GOPROXY=https://proxy.golang.org,direct",
      "cn": "go env -w GOPROXY=https://goproxy.cn,direct",
      "docs": "https://go.dev/ref/mod"
    },
    {
      "name": "Java + Maven",
      "how": {
        "zh": "将片段放入 ~/.m2/settings.xml 的 <mirrors> 节点。",
        "en": "Place the snippet inside the <mirrors> node in ~/.m2/settings.xml."
      },
      "file": "~/.m2/settings.xml",
      "official": "<mirror>\n  <id>central</id>\n  <mirrorOf>central</mirrorOf>\n  <url>https://repo.maven.apache.org/maven2</url>\n</mirror>",
      "cn": "<mirror>\n  <id>aliyunmaven</id>\n  <mirrorOf>*</mirrorOf>\n  <url>https://maven.aliyun.com/repository/public</url>\n</mirror>",
      "docs": "https://maven.apache.org/guides/mini/guide-mirror-settings.html"
    },
    {
      "name": "Bun",
      "how": {
        "zh": "写入项目 bunfig.toml，或改为全局 ~/.bunfig.toml。",
        "en": "Use in a project bunfig.toml or the global ~/.bunfig.toml."
      },
      "file": "~/.bunfig.toml",
      "official": "[install]\nregistry = \"https://registry.npmjs.org/\"",
      "cn": "[install]\nregistry = \"https://registry.npmmirror.com/\"",
      "docs": "https://bun.sh/docs/runtime/bunfig"
    },
    {
      "name": "pnpm",
      "how": {
        "zh": "pnpm 的 registry 配置写入全局 rc。",
        "en": "Writes pnpm's registry setting to its global rc file."
      },
      "official": "pnpm config set registry https://registry.npmjs.org/",
      "cn": "pnpm config set registry https://registry.npmmirror.com/",
      "docs": "https://pnpm.io/cli/config"
    },
    {
      "name": "Rust + Cargo",
      "how": {
        "zh": "将片段放入 ~/.cargo/config.toml；镜像使用 Sparse Index。",
        "en": "Place the snippet in ~/.cargo/config.toml; the mirror uses Cargo's sparse index."
      },
      "file": "~/.cargo/config.toml",
      "official": "[source.crates-io]\nregistry = \"sparse+https://index.crates.io/\"",
      "cn": "[source.crates-io]\nreplace-with = \"rsproxy-sparse\"\n\n[source.rsproxy-sparse]\nregistry = \"sparse+https://rsproxy.cn/index/\"",
      "docs": "https://doc.rust-lang.org/cargo/reference/source-replacement.html"
    }
  ],
  "agents": [
    {
      "name": "ama",
      "provider": "Owlbay",
      "runtime": "mise-node",
      "install": "npm install -g @armadra/agent",
      "start": "ama",
      "desc": {
        "zh": "独立运行或嵌入 Armadra 的编码与协调 Agent。",
        "en": "A coding and coordination agent that runs standalone or embedded in Armadra."
      },
      "docs": "https://github.com/Owlbay/armadra-agent",
      "tier": "core",
      "featured": true
    },
    {
      "name": "Codex CLI",
      "provider": "OpenAI",
      "runtime": "mise-node",
      "install": "npm install -g @openai/codex",
      "start": "codex",
      "desc": {
        "zh": "在终端中读取、修改并运行本地代码，适合实现功能、修复问题和理解仓库。",
        "en": "Reads, edits, and runs local code from the terminal for implementation, debugging, and repository understanding."
      },
      "docs": "https://help.openai.com/en/articles/11096431-openai-codex-cli-getting-started",
      "tier": "core"
    },
    {
      "name": "Claude Code",
      "provider": "Anthropic",
      "runtime": "mise-node",
      "install": "npm install -g @anthropic-ai/claude-code",
      "start": "claude",
      "desc": {
        "zh": "面向代码库的终端 Agent，擅长理解上下文、修改代码和执行开发命令。",
        "en": "A repository-aware terminal agent for understanding context, editing code, and running development commands."
      },
      "docs": "https://docs.anthropic.com/en/docs/claude-code/getting-started",
      "tier": "core"
    },
    {
      "name": "GitHub Copilot CLI",
      "provider": "GitHub",
      "runtime": "mise-node",
      "install": "npm install -g @github/copilot",
      "start": "copilot",
      "desc": {
        "zh": "把 Copilot 带进终端，可在现有 GitHub 与开发工作流中执行 Agent 任务。",
        "en": "Brings Copilot into the terminal for agentic work inside existing GitHub and development workflows."
      },
      "docs": "https://docs.github.com/en/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli",
      "tier": "extra"
    },
    {
      "name": "Gemini CLI",
      "provider": "Google",
      "runtime": "mise-node",
      "install": "npm install -g @google/gemini-cli",
      "start": "gemini",
      "desc": {
        "zh": "开源终端 Agent，支持文件、Shell、网页工具与 MCP，适合在终端中完成多步骤开发任务。",
        "en": "An open-source terminal agent with file, shell, web, and MCP tools for multi-step development work."
      },
      "docs": "https://github.com/google-gemini/gemini-cli",
      "tier": "extra"
    },
    {
      "name": "OpenCode CLI",
      "provider": "Anomaly",
      "runtime": "standalone",
      "install": "mise use -g github:anomalyco/opencode",
      "start": "opencode",
      "desc": {
        "zh": "开源 Coding Agent，可在终端、桌面或 IDE 中使用，并支持多家模型提供商。",
        "en": "An open-source coding agent available in terminal, desktop, and IDE surfaces with broad model support."
      },
      "docs": "https://opencode.ai/docs/",
      "tier": "extra"
    },
    {
      "name": "Pi",
      "provider": "Pi",
      "runtime": "mise-node",
      "install": "npm install -g --ignore-scripts @earendil-works/pi-coding-agent",
      "start": "pi",
      "desc": {
        "zh": "保持核心极简、通过 TypeScript 扩展和技能组合能力的终端 Coding Agent。",
        "en": "A minimal terminal coding agent designed to grow through TypeScript extensions, skills, and packages."
      },
      "docs": "https://pi.dev/docs/latest",
      "tier": "core"
    },
    {
      "name": "OMP / Oh My Pi",
      "provider": "OMP",
      "runtime": "standalone",
      "install": "mise use -g github:can1357/oh-my-pi",
      "start": "omp",
      "desc": {
        "zh": "Pi 的增强分支，内置 LSP、调试、浏览器、子 Agent 与更完整的编码工具面。",
        "en": "A batteries-included Pi fork with LSP, debugging, browser, subagents, and a broader coding tool surface."
      },
      "docs": "https://omp.sh/",
      "tier": "extra"
    },
    {
      "name": "Cursor Agent",
      "provider": "Cursor",
      "runtime": "standalone",
      "install": "curl https://cursor.com/install -fsS | bash",
      "start": "cursor-agent",
      "desc": {
        "zh": "Cursor 的终端 Agent，可交互运行，也可用于脚本和 CI 自动化。",
        "en": "Cursor's terminal agent for interactive work, scripts, and CI automation."
      },
      "docs": "https://docs.cursor.com/en/cli/installation",
      "tier": "extra"
    }
  ],
  "agentRoles": [
    {
      "name": {
        "zh": "直接执行",
        "en": "Direct execution"
      },
      "desc": {
        "zh": "ama、Codex、Claude Code、OpenCode、Gemini、Copilot 与 Cursor Agent 直接读取、修改和运行项目代码。",
        "en": "ama, Codex, Claude Code, OpenCode, Gemini, Copilot, and Cursor Agent read, modify, and run project code directly."
      }
    },
    {
      "name": {
        "zh": "会话与界面",
        "en": "Sessions and interface"
      },
      "desc": {
        "zh": "Herdr 保持 Agent 终端会话，T3 Code 提供统一控制界面。",
        "en": "Herdr keeps agent terminals alive; T3 Code provides one control surface."
      }
    },
    {
      "name": {
        "zh": "任务协作",
        "en": "Task coordination"
      },
      "desc": {
        "zh": "ama 既能独立编码，也能作为协调 Agent 工作，可嵌入 Armadra；Multica 负责把任务分配给已安装的 Agent，并跟踪执行进度。",
        "en": "ama codes on its own or works as a coordination agent, and can be embedded in Armadra; Multica assigns work to installed agents and tracks progress."
      }
    }
  ],
  "categories": [
    {
      "id": "shell",
      "name": {
        "zh": "终端与 Shell",
        "en": "Terminal & Shell"
      }
    },
    {
      "id": "dev",
      "name": {
        "zh": "开发基础设施",
        "en": "Development"
      }
    },
    {
      "id": "ai",
      "name": {
        "zh": "AI 与智能开发",
        "en": "AI & Agents"
      }
    },
    {
      "id": "editors",
      "name": {
        "zh": "编辑器与开发应用",
        "en": "Editors & Dev Apps"
      }
    },
    {
      "id": "system",
      "name": {
        "zh": "系统与效率工具",
        "en": "System & Utilities"
      }
    },
    {
      "id": "network",
      "name": {
        "zh": "网络与连接",
        "en": "Network & Connectivity"
      }
    },
    {
      "id": "productivity",
      "name": {
        "zh": "沟通与生产力",
        "en": "Communication & Productivity"
      }
    }
  ],
  "software": [
    {
      "name": "Bash",
      "category": "shell",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "提供新版 Bash，适合需要 GNU Shell 行为和脚本兼容性的工作流。",
        "en": "A current Bash release for workflows that depend on GNU shell behavior and script compatibility."
      },
      "install": "brew install bash",
      "url": "https://www.gnu.org/software/bash/"
    },
    {
      "name": "Zsh",
      "category": "shell",
      "kind": "cli",
      "tier": "extra",
      "desc": {
        "zh": "macOS 默认 Shell，补全与扩展生态成熟，是组织终端工作流的核心层。",
        "en": "The default macOS shell, with a mature completion and plugin ecosystem for a well-structured terminal workflow."
      },
      "install": "brew install zsh",
      "url": "https://www.zsh.org/"
    },
    {
      "name": "Starship",
      "category": "shell",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "跨 Shell 的轻量提示符，用清晰方式展示目录、Git 和运行时信息。",
        "en": "A lightweight cross-shell prompt that keeps directory, Git, and runtime context visible."
      },
      "install": "brew install starship",
      "url": "https://starship.rs/"
    },
    {
      "name": "tmux",
      "category": "shell",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "让终端会话可以分屏、断开后继续运行，适合远程与长任务。",
        "en": "Split panes and keep sessions alive across disconnects—ideal for remote and long-running work."
      },
      "install": "brew install tmux",
      "url": "https://tmux.github.io/"
    },
    {
      "name": "zsh-autosuggestions",
      "category": "shell",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "根据命令历史即时给出补全建议，减少重复输入。",
        "en": "Suggests commands from history as you type, cutting down repetitive input."
      },
      "install": "brew install zsh-autosuggestions",
      "url": "https://github.com/zsh-users/zsh-autosuggestions"
    },
    {
      "name": "zsh-history-substring-search",
      "category": "shell",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "输入部分内容后用上下键查找匹配历史，比逐条翻找更高效。",
        "en": "Search matching history with the arrow keys after typing a fragment."
      },
      "install": "brew install zsh-history-substring-search",
      "url": "https://github.com/zsh-users/zsh-history-substring-search"
    },
    {
      "name": "zsh-syntax-highlighting",
      "category": "shell",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "执行前高亮命令与参数，帮助更快发现拼写和路径错误。",
        "en": "Highlights commands and arguments before execution to catch typos and path errors sooner."
      },
      "install": "brew install zsh-syntax-highlighting",
      "url": "https://github.com/zsh-users/zsh-syntax-highlighting"
    },
    {
      "name": "fzf",
      "category": "shell",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "通用命令行模糊查找器，可快速筛选文件、历史命令、Git 分支和其他列表。",
        "en": "A general-purpose command-line fuzzy finder for files, command history, Git branches, and any other list."
      },
      "install": "brew install fzf",
      "url": "https://junegunn.github.io/fzf/"
    },
    {
      "name": "zoxide",
      "category": "shell",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "根据使用频率学习常去目录，用更短的输入快速跳转路径。",
        "en": "Learns frequently visited directories and jumps to them with much shorter input."
      },
      "install": "brew install zoxide",
      "url": "https://github.com/ajeetdsouza/zoxide"
    },
    {
      "name": "iTerm2",
      "category": "shell",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "成熟的 macOS 终端，分屏、Profiles、快捷键和 Shell Integration 都很完整。",
        "en": "A mature macOS terminal with strong panes, profiles, shortcuts, and shell integration."
      },
      "install": "brew install --cask iterm2",
      "url": "https://iterm2.com/"
    },
    {
      "name": "Otty",
      "category": "shell",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "原生 GPU 加速终端，提供标签页、分屏、会话恢复，并针对 Coding Agent 工作流优化。",
        "en": "A native GPU-accelerated terminal with tabs, splits, session recovery, and workflows designed around coding agents."
      },
      "install": "open https://otty.sh/",
      "url": "https://otty.sh/"
    },
    {
      "name": "SauceCodePro Nerd Font",
      "category": "shell",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "为终端提示符补齐图标字形，同时保留适合代码阅读的等宽体验。",
        "en": "Adds icon glyphs for rich prompts while keeping a readable monospaced coding face."
      },
      "install": "brew install --cask font-sauce-code-pro-nerd-font",
      "url": "https://github.com/ryanoasis/nerd-fonts"
    },
    {
      "name": "CMake",
      "category": "dev",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "跨平台构建配置的事实标准，常见于 C、C++ 和原生依赖项目。",
        "en": "The standard cross-platform build system for C, C++, and native dependency projects."
      },
      "install": "brew install cmake",
      "url": "https://cmake.org/"
    },
    {
      "name": "Docker CLI",
      "category": "dev",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "通过容器统一开发与运行环境，降低机器之间的环境差异。",
        "en": "Packages development and runtime environments into portable containers."
      },
      "install": "brew install docker",
      "url": "https://www.docker.com/"
    },
    {
      "name": "Docker Completion",
      "category": "dev",
      "kind": "cli",
      "tier": "extra",
      "desc": {
        "zh": "为 Docker 命令、子命令和参数提供 Shell 补全。",
        "en": "Adds shell completion for Docker commands, subcommands, and options."
      },
      "install": "brew install docker-completion",
      "url": "https://www.docker.com/"
    },
    {
      "name": "Git",
      "category": "dev",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "软件开发的核心版本控制工具，新版通常带来更好的性能与安全修复。",
        "en": "The foundation of source control, with current performance and security improvements."
      },
      "install": "brew install git",
      "url": "https://git-scm.com/"
    },
    {
      "name": "GitHub CLI",
      "category": "dev",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "直接在终端管理仓库、Issue、PR 和 Actions，减少网页来回切换。",
        "en": "Manage repositories, issues, pull requests, and Actions without leaving the terminal."
      },
      "install": "brew install gh",
      "url": "https://cli.github.com/"
    },
    {
      "name": "HarfBuzz",
      "category": "dev",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "可靠的 OpenType 文字塑形引擎，是字体、图形和文档工具常见底层依赖。",
        "en": "A dependable OpenType shaping engine used throughout font, graphics, and document stacks."
      },
      "install": "brew install harfbuzz",
      "url": "https://github.com/harfbuzz/harfbuzz"
    },
    {
      "name": "MySQL Client",
      "category": "dev",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "只安装 MySQL 客户端即可连接远程数据库，不必在本机运行完整服务。",
        "en": "Connect to remote MySQL databases without installing and running the full local server."
      },
      "install": "brew install mysql-client",
      "url": "https://github.com/mysql/mysql-server"
    },
    {
      "name": "Open MPI",
      "category": "dev",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "为并行计算和多进程科研任务提供成熟的消息传递实现。",
        "en": "A mature message-passing implementation for parallel and scientific workloads."
      },
      "install": "brew install open-mpi",
      "url": "https://www.open-mpi.org/"
    },
    {
      "name": "Protocol Buffers",
      "category": "dev",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "用 Schema 定义跨语言数据结构，适合 API、RPC 和高效序列化。",
        "en": "Schema-first, cross-language data structures for APIs, RPC, and efficient serialization."
      },
      "install": "brew install protobuf",
      "url": "https://protobuf.dev/"
    },
    {
      "name": "Ruff",
      "category": "dev",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "速度很快的 Python Linter 与 Formatter，可替代多项分散工具。",
        "en": "A very fast Python linter and formatter that consolidates several separate tools."
      },
      "install": "brew install ruff",
      "url": "https://docs.astral.sh/ruff/"
    },
    {
      "name": "scc",
      "category": "dev",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "快速统计代码量、语言分布和复杂度，适合了解项目规模与辅助估算。",
        "en": "Quickly profiles code size, language mix, and complexity to clarify project scale and support estimates."
      },
      "install": "brew install scc",
      "url": "https://github.com/boyter/scc/"
    },
    {
      "name": "unixODBC",
      "category": "dev",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "为需要 ODBC 的数据库工具提供统一连接层。",
        "en": "Provides a common ODBC connectivity layer for database clients and integrations."
      },
      "install": "brew install unixodbc",
      "url": "https://www.unixodbc.org/"
    },
    {
      "name": "uv",
      "category": "dev",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "高速管理 Python 依赖、虚拟环境和项目运行，适合现代 Python 工作流。",
        "en": "Fast Python dependency, environment, and project management for modern workflows."
      },
      "install": "brew install uv",
      "url": "https://docs.astral.sh/uv/"
    },
    {
      "name": "Wget",
      "category": "dev",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "稳定的命令行下载工具，适合脚本、递归下载与断点续传。",
        "en": "A reliable CLI downloader for scripts, recursive fetches, and resumable transfers."
      },
      "install": "brew install wget",
      "url": "https://www.gnu.org/software/wget/"
    },
    {
      "name": "Mise",
      "category": "dev",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "统一管理 Node.js、Python、Go、Java 等运行时及项目级版本。",
        "en": "Manages Node.js, Python, Go, Java, and other runtimes with project-level versions."
      },
      "install": "curl https://mise.run | sh",
      "url": "https://mise.jdx.dev/"
    },
    {
      "name": "ripgrep",
      "category": "dev",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "高速的递归文本搜索工具，类似 grep 与 The Silver Searcher。",
        "en": "Search tool like grep and The Silver Searcher."
      },
      "install": "brew install ripgrep",
      "url": "https://github.com/BurntSushi/ripgrep"
    },
    {
      "name": "gitleaks",
      "category": "dev",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "扫描 Git 仓库与提交，发现误提交的密钥和凭据。",
        "en": "Audit git repos for secrets."
      },
      "install": "brew install gitleaks",
      "url": "https://gitleaks.io/"
    },
    {
      "name": "git-filter-repo",
      "category": "dev",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "快速改写 Git 仓库历史，适合清理大文件或误提交的敏感内容。",
        "en": "Quickly rewrite git repository history."
      },
      "install": "brew install git-filter-repo",
      "url": "https://github.com/newren/git-filter-repo"
    },
    {
      "name": "Android SDK Platform-Tools",
      "category": "dev",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "Android SDK 组件，提供 adb、fastboot 等设备调试工具。",
        "en": "Android SDK component with adb, fastboot and other device tools."
      },
      "install": "brew install --cask android-platform-tools",
      "url": "https://developer.android.com/tools/releases/platform-tools"
    },
    {
      "name": "Herdr",
      "category": "ai",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "在终端里集中切换和观察多个 Coding Agent，减少窗口与上下文混乱。",
        "en": "Multiplexes multiple coding agents in one terminal to reduce window and context sprawl."
      },
      "install": "brew install herdr",
      "url": "https://herdr.dev/"
    },
    {
      "name": "Multica",
      "category": "ai",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "把本地 Coding Agent 接入任务协作流程，适合并行分派与跟踪工作。",
        "en": "Connects local coding agents to a collaborative task workflow for assignment and tracking."
      },
      "install": "brew install multica-ai/tap/multica",
      "url": "https://multica.ai/"
    },
    {
      "name": "ChatGPT",
      "category": "ai",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "官方桌面客户端，适合随时调用对话、文件与多模态能力。",
        "en": "The official desktop client for quick access to conversations, files, and multimodal work."
      },
      "install": "brew install --cask chatgpt",
      "url": "https://chatgpt.com/"
    },
    {
      "name": "Claude",
      "category": "ai",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "Anthropic 官方桌面客户端，适合长文本理解、写作与项目协作。",
        "en": "Anthropic's official desktop client for long-form reasoning, writing, and project work."
      },
      "install": "brew install --cask claude",
      "url": "https://claude.com/download"
    },
    {
      "name": "OpenCode Desktop",
      "category": "ai",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "为 OpenCode Agent 提供桌面界面，适合不想全程停留在终端的使用方式。",
        "en": "A desktop interface for the OpenCode agent when a visual workspace is preferable to the terminal."
      },
      "install": "brew install --cask opencode-desktop",
      "url": "https://opencode.ai/"
    },
    {
      "name": "T3 Code",
      "category": "ai",
      "kind": "app",
      "tier": "extra",
      "desc": {
        "zh": "极简的 AI Coding Agent 图形界面，便于集中管理编码会话。",
        "en": "A minimal graphical workspace for keeping AI coding-agent sessions organized."
      },
      "install": "brew install --cask t3-code",
      "url": "https://t3.codes/"
    },
    {
      "name": "Google Antigravity",
      "category": "ai",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "Google 的 Agent 编排平台。",
        "en": "Agent orchestration platform from Google."
      },
      "install": "brew install --cask antigravity",
      "url": "https://antigravity.google/product/antigravity-2"
    },
    {
      "name": "Cherry Studio",
      "category": "ai",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "支持多家大模型服务商的桌面客户端。",
        "en": "Desktop client that supports multiple LLM providers."
      },
      "install": "brew install --cask cherry-studio",
      "url": "https://www.cherry-ai.com/"
    },
    {
      "name": "CodexBar",
      "category": "ai",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "菜单栏显示 Codex 与 Claude 用量的监控工具。",
        "en": "Menu bar usage monitor for Codex and Claude."
      },
      "install": "brew install --cask codexbar",
      "url": "https://codexbar.app/"
    },
    {
      "name": "IntelliJ IDEA",
      "category": "editors",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "成熟的 JVM IDE，代码分析、重构和框架支持非常完整。",
        "en": "A mature JVM IDE with deep analysis, refactoring, and framework support."
      },
      "install": "brew install --cask intellij-idea",
      "url": "https://www.jetbrains.com/idea/"
    },
    {
      "name": "Visual Studio Code",
      "category": "editors",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "生态广、上手快，适合多语言开发与远程工作流。",
        "en": "A broadly supported editor with a deep extension ecosystem and strong remote workflows."
      },
      "install": "brew install --cask visual-studio-code",
      "url": "https://code.visualstudio.com/"
    },
    {
      "name": "Zed",
      "category": "editors",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "强调高性能和协作体验的现代代码编辑器，界面简洁。",
        "en": "A modern, high-performance editor with a clean interface and collaboration features."
      },
      "install": "brew install --cask zed",
      "url": "https://zed.dev/"
    },
    {
      "name": "Sublime Text",
      "category": "editors",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "启动快、响应轻巧，适合临时编辑、超大文本和专注写代码。",
        "en": "Fast to launch and responsive—excellent for quick edits, large files, and focused coding."
      },
      "install": "brew install --cask sublime-text",
      "url": "https://www.sublimetext.com/"
    },
    {
      "name": "Apifox",
      "category": "editors",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "把 API 设计、调试、Mock 与文档放在一个协作界面中。",
        "en": "Combines API design, debugging, mocks, and documentation in one collaborative workspace."
      },
      "install": "brew install --cask apifox",
      "url": "https://apifox.com/"
    },
    {
      "name": "Another Redis Desktop Manager",
      "category": "editors",
      "kind": "app",
      "tier": "extra",
      "desc": {
        "zh": "跨平台查看和管理 Redis 数据，适合开发调试与日常排查。",
        "en": "A cross-platform Redis browser for development, debugging, and routine inspection."
      },
      "install": "brew install --cask another-redis-desktop-manager",
      "url": "https://github.com/qishibo/AnotherRedisDesktopManager/"
    },
    {
      "name": "Proxyman",
      "category": "editors",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "原生 macOS HTTP 调试代理，适合检查移动端和 Web 请求。",
        "en": "A native macOS HTTP debugging proxy for inspecting mobile and web traffic."
      },
      "install": "brew install --cask proxyman",
      "url": "https://proxyman.com/"
    },
    {
      "name": "draw.io",
      "category": "editors",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "免费且通用的流程图与架构图工具，文件可本地保存。",
        "en": "A free, general-purpose diagramming tool with local file support."
      },
      "install": "brew install --cask drawio",
      "url": "https://www.diagrams.net/"
    },
    {
      "name": "Typora",
      "category": "editors",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "所见即所得的 Markdown 编辑器，适合专注文档写作。",
        "en": "A focused what-you-see-is-what-you-get Markdown editor for documentation and writing."
      },
      "install": "brew install --cask typora",
      "url": "https://typora.io/"
    },
    {
      "name": "Obsidian",
      "category": "editors",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "基于本地 Markdown 的知识库，适合长期笔记、链接与个人知识管理。",
        "en": "A local Markdown knowledge base for durable notes, links, and personal knowledge management."
      },
      "install": "brew install --cask obsidian",
      "url": "https://obsidian.md/"
    },
    {
      "name": "Cursor",
      "category": "editors",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "内置 AI 的代码编辑器，可在编辑器内对话、修改代码。",
        "en": "Write, edit, and chat about your code with AI."
      },
      "install": "brew install --cask cursor",
      "url": "https://www.cursor.com/"
    },
    {
      "name": "Mole",
      "category": "system",
      "kind": "cli",
      "tier": "core",
      "desc": {
        "zh": "从终端清理缓存、日志与残留文件，并帮助快速判断磁盘占用。",
        "en": "Cleans caches, logs, and leftovers from the terminal while helping explain disk usage."
      },
      "install": "brew install mole",
      "url": "https://mole.fit/"
    },
    {
      "name": "AppCleaner",
      "category": "system",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "卸载应用时一并定位相关支持文件，减少长期残留。",
        "en": "Finds related support files when uninstalling apps to reduce long-term leftovers."
      },
      "install": "brew install --cask appcleaner",
      "url": "https://freemacsoft.net/appcleaner/"
    },
    {
      "name": "balenaEtcher",
      "category": "system",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "用清晰的图形流程把系统镜像安全写入 U 盘或 SD 卡。",
        "en": "A clear visual workflow for safely flashing OS images to USB drives and SD cards."
      },
      "install": "brew install --cask balenaetcher",
      "url": "https://etcher.balena.io/"
    },
    {
      "name": "BetterDisplay",
      "category": "system",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "精细控制分辨率、缩放与虚拟屏幕，适合复杂外接显示器环境。",
        "en": "Fine-grained resolution, scaling, and virtual display controls for complex monitor setups."
      },
      "install": "brew install --cask betterdisplay",
      "url": "https://betterdisplay.pro/"
    },
    {
      "name": "MonitorControl",
      "category": "system",
      "kind": "app",
      "tier": "extra",
      "desc": {
        "zh": "直接用 macOS 键盘控制外接显示器亮度与音量。",
        "en": "Controls external display brightness and volume from standard macOS keys."
      },
      "install": "brew install --cask monitorcontrol",
      "url": "https://github.com/MonitorControl/MonitorControl"
    },
    {
      "name": "Mos",
      "category": "system",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "独立调整鼠标滚轮方向和顺滑度，不影响触控板习惯。",
        "en": "Adjusts mouse scrolling direction and smoothness independently from the trackpad."
      },
      "install": "brew install --cask mos",
      "url": "https://mos.caldis.me/"
    },
    {
      "name": "Rectangle",
      "category": "system",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "用快捷键快速排列窗口，是轻量又可靠的窗口管理方案。",
        "en": "A lightweight, reliable way to arrange windows with keyboard shortcuts."
      },
      "install": "brew install --cask rectangle",
      "url": "https://rectangleapp.com/"
    },
    {
      "name": "Hapigo",
      "category": "system",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "集应用启动、搜索与自动化于一体，适合键盘驱动的效率工作流。",
        "en": "Combines app launching, search, and automation for keyboard-driven workflows."
      },
      "install": "brew install --cask hapigo",
      "url": "https://www.hapigo.com/"
    },
    {
      "name": "IINA",
      "category": "system",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "贴合 macOS 设计的开源播放器，格式支持全面且操作轻快。",
        "en": "A native-feeling open-source macOS player with broad format support."
      },
      "install": "brew install --cask iina",
      "url": "https://iina.io/"
    },
    {
      "name": "OrbStack",
      "category": "system",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "在 macOS 上提供轻量的容器与 Linux 虚拟机体验，启动快、资源占用低。",
        "en": "Fast, resource-efficient containers and Linux machines designed for macOS."
      },
      "install": "brew install --cask orbstack",
      "url": "https://orbstack.dev/"
    },
    {
      "name": "Parallels Desktop",
      "category": "system",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "成熟的桌面虚拟化方案，适合在 Mac 上运行 Windows 与其他系统。",
        "en": "A mature desktop virtualization option for running Windows and other systems on Mac."
      },
      "install": "brew install --cask parallels",
      "url": "https://www.parallels.com/products/desktop/"
    },
    {
      "name": "PDF Expert",
      "category": "system",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "界面简洁的 PDF 阅读、批注与编辑工具，适合高频文档工作。",
        "en": "A polished PDF reader, annotator, and editor for frequent document work."
      },
      "install": "brew install --cask pdf-expert",
      "url": "https://pdfexpert.com/"
    },
    {
      "name": "PicList",
      "category": "system",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "管理多种对象存储并快速上传图片，适合博客和文档图床工作流。",
        "en": "Manages multiple object stores and image uploads for blogging and documentation workflows."
      },
      "install": "brew install --cask piclist",
      "url": "https://piclist.cn/"
    },
    {
      "name": "Clash Party",
      "category": "network",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "基于 Mihomo 的图形网络客户端，适合需要可视化规则与连接管理的用户。",
        "en": "A Mihomo-based visual network client for users who need rule and connection management."
      },
      "install": "brew install --cask clash-party",
      "url": "https://clashparty.org/"
    },
    {
      "name": "Stash",
      "category": "network",
      "kind": "app",
      "tier": "extra",
      "desc": {
        "zh": "面向 Apple 平台的规则网络工具，适合精细分流和网络调试。",
        "en": "An Apple-platform rule-based network tool for granular routing and debugging."
      },
      "install": "brew install --cask stash",
      "url": "https://stash.ws/"
    },
    {
      "name": "Surge",
      "category": "network",
      "kind": "app",
      "tier": "extra",
      "desc": {
        "zh": "专业的网络工具箱，覆盖代理、抓包、规则和自动化。",
        "en": "A professional network toolbox spanning proxying, inspection, rules, and automation."
      },
      "install": "brew install --cask surge",
      "url": "https://nssurge.com/"
    },
    {
      "name": "Tailscale",
      "category": "network",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "基于 WireGuard 连接设备与服务，几乎不需要传统 VPN 配置。",
        "en": "Connects devices and services over WireGuard without traditional VPN complexity."
      },
      "install": "brew install --cask tailscale",
      "url": "https://tailscale.com/"
    },
    {
      "name": "Google Chrome",
      "category": "productivity",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "兼容性广、开发者工具成熟，是日常浏览和 Web 开发的通用选择。",
        "en": "Broad compatibility and mature developer tools make it a versatile choice for everyday browsing and web development."
      },
      "install": "brew install --cask google-chrome",
      "url": "https://www.google.com/chrome/"
    },
    {
      "name": "QQ Music",
      "category": "productivity",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "覆盖中文音乐内容与多端歌单同步，适合日常聆听。",
        "en": "Strong Chinese music coverage with playlist sync across devices."
      },
      "install": "brew install --cask qqmusic",
      "url": "https://y.qq.com/"
    },
    {
      "name": "QQ",
      "category": "productivity",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "常用即时通信工具，适合保留工作与个人联系的兼容入口。",
        "en": "A widely used messaging client for maintaining work and personal communication compatibility."
      },
      "install": "brew install --cask qq",
      "url": "https://im.qq.com/index/#/macos"
    },
    {
      "name": "Tencent Meeting",
      "category": "productivity",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "国内常见的视频会议工具，兼容企业会议与屏幕共享场景。",
        "en": "A common video meeting client in China with solid enterprise and screen-sharing support."
      },
      "install": "brew install --cask tencent-meeting",
      "url": "https://meeting.tencent.com/"
    },
    {
      "name": "WeChat",
      "category": "productivity",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "覆盖日常沟通、文件传输与国内协作场景。",
        "en": "Covers everyday messaging, file transfer, and collaboration in the Chinese ecosystem."
      },
      "install": "brew install --cask wechat",
      "url": "https://mac.weixin.qq.com/"
    },
    {
      "name": "WPS Office",
      "category": "productivity",
      "kind": "app",
      "tier": "core",
      "desc": {
        "zh": "兼容常见 Office 文档格式，并针对中文办公场景提供完整套件。",
        "en": "A full office suite with strong compatibility and features tailored to Chinese workflows."
      },
      "install": "brew install --cask wpsoffice-cn",
      "url": "https://mac.wps.cn/"
    }
  ],
  "agentPrompt": {
    "zh": "请把本站剩余软件当作候选清单，不要全部直接安装。\n\n先完成以下工作：\n1. 询问我的用途和偏好；\n2. 列出建议安装的软件、推荐理由、官网、安装命令和所需权限；\n3. 标记会修改 Shell、网络、系统扩展或登录项的操作；\n4. 等待我逐项确认。\n\n只有在我确认后，才执行对应命令。不要安装未确认的软件，也不要更改与当前任务无关的配置。",
    "en": "Treat the remaining software on this site as candidates, not an install-all list.\n\nFirst:\n1. Ask about my use cases and preferences.\n2. List the software you recommend, why, its official site, install command, and required permissions.\n3. Flag anything that changes the shell, network, system extensions, or login items.\n4. Wait for my item-by-item approval.\n\nRun a command only after I approve it. Do not install unapproved software or change configuration unrelated to the current task."
  }
}