Software
This page lists common fresh-machine applications. The download links point to official project pages, while repeatable installs should use Homebrew manifests or the thin helper script in this repository.
Install Strategy
- Use
Brewfilefor terminal foundations and daily CLI tools. - Use
Brewfile.appsfor optional desktop applications. - Keep download links for apps that need manual review, account setup, or license checks.
- Keep one-off experiments out of the manifests until they become part of daily work.
Interactive Catalog
Foundation
1- Homebrew
homebrewInstall this manually before running Homebrew manifests.
Terminal and editor
4- iTerm2
iterm2 - Visual Studio Code
vscode - Cursor
cursor - Codex CLI
codex-cliTerminal agent for repository work. The official OpenAI docs also list a standalone installer.
AI coding
1- Codex App
codexDesktop command center for Codex agents.
Launcher and browsers
3- Raycast
raycast - Google Chrome
chrome - Firefox Developer Edition
firefox-dev
Communication and media
4- NetEase Cloud Music
neteasemusic - QQ
qq - WeChat
wechat - Feishu
feishu
Containers
2- OrbStack
orbstack - Docker Desktop
dockerManual download link only; review Docker Desktop subscription terms before installing. OrbStack is the default container runtime.
Productivity
5- Microsoft To Do
microsoft-todoMac App Store install. The mas CLI requires App Store sign-in.
- 1Password
1password - Obsidian
obsidian - Notion
notion - ima.copilot
imaTencent AI workspace. No Homebrew cask is currently available; download from the official page.
Quick Commands
List known software ids:
pnpm software listOpen selected official download pages:
pnpm software:open microsoft-todo vscode neteasemusic qq wechat codex chrome raycast feishuShow install status from the shared software catalog:
pnpm software:status
pnpm software:missingCheck install state before changing the machine:
pnpm software:check --core
pnpm software:check --appsInstall the terminal foundation:
pnpm software:install --coreInstall optional desktop apps:
pnpm software:install --appsBrewfile.apps also includes Mac App Store apps through mas, so sign in to the App Store before installing those entries.
Install both manifests:
pnpm software:install --allSkill vs Script
A Codex skill can help operate or document the setup flow, but it is not the best source of truth for machine state. Scripts and package-manager manifests are better because they are versioned in the repository, reviewable in pull requests, and safe to rerun.
Use skills for orchestration and maintenance notes. Use Brewfile, Brewfile.apps, and pnpm software:* commands for actual installs. See Codex Skills for when to use a skill, local script, or plugin.