CodexOpsStudio

Open-source macOS multi-agent workspace for Codex CLI, built with SwiftUI.

CodexOpsStudio turns a single prompt into a staged local development workflow: an orchestrator analyzes the repo, specialists split the work, review gates protect write access, Git worktrees isolate changes, and GitHub actions stay explicitly user-confirmed.

中文简介：这是一个基于 SwiftUI 的 macOS 原生多 Agent 开发操作台，围绕 Codex CLI、Git worktree、本地自动化和 GitHub 发布门禁来设计。

Why this project exists

Most AI coding tools are still optimized for one model talking in one thread. Real software work is messier:

• one role needs to plan
• one role needs to inspect repository structure
• another role needs to review code quality
• Git history needs to stay reversible
• GitHub publishing needs a safety gate

CodexOpsStudio is an attempt to make that workflow visible and operable in a native desktop app instead of a pile of terminal tabs.

What it does

• Accepts one high-level requirement for one local Git repository
• Runs a live Codex CLI orchestrator plan with structured JSON event parsing
• Dynamically launches specialist agents based on the task
• Supports read-only analysis before any write stage
• Uses a write gate plus limited rework loop before code modification
• Runs a single selected writer inside an isolated Git worktree
• Supports conservative write, semi-automatic recovery, and automatic local commit
• Shows a center-stage timeline for orchestration progress and final report output
• Provides a dedicated right-side Agent drawer for live specialist execution details
• Surfaces diff review, publish readiness, local commit state, and GitHub confirmation actions
• Keeps push and Draft PR creation explicitly user-confirmed

Core keywords

If you found this project through search, these are the problems it is built for:

• Codex CLI desktop app
• multi-agent coding workspace
• SwiftUI macOS AI coding tool
• Codex CLI GUI
• local-first AI developer console
• Git worktree orchestration
• multi-agent software engineering on macOS

Product shape

CodexOpsStudio is currently organized around three columns:

• Left: task sessions
• Center: orchestrator timeline, staged progress, final report
• Right: Agent drawer, review, publish gate

The current UX direction combines:

• Codex App-style thread clarity
• operations timeline visibility
• repository-safe local Git workflows

Workflow

User requirement
  -> Orchestrator analysis
  -> Dynamic specialist planning
  -> Read-only specialist execution
  -> Reviewer / write gate
  -> Single-writer worktree execution
  -> Recovery / local commit
  -> GitHub-confirmed push or Draft PR

Current capabilities

Orchestration

• Live codex exec --json planner integration
• Dynamic specialist role generation
• Read-only specialist execution
• Reviewer handoff
• Timeline-based progress rendering

Repository safety

• Single repository focus
• Non-ASCII path compatibility via temporary ASCII aliasing
• Isolated writer worktrees
• Automatic local Git recovery flows
• GitHub actions behind explicit confirmation

Desktop UX

• Native macOS app with SwiftUI and AppKit
• Compact session list
• Timeline-first center workspace
• Agent drawer for streaming specialist output
• Diff review and publish-readiness inspection
• Session persistence across relaunches

Requirements

• macOS 13+
• Swift 6 toolchain
• Codex CLI installed locally
• Git
• GitHub CLI (gh) if you want in-app push / Draft PR actions

Run locally

cd /Users/cwn/Desktop/所有文件夹/一些实用小工具/CodexOpsStudio
swift build
swift run CodexOpsStudioApp

Current status

This repository is currently an active prototype with a working app shell and real Codex CLI orchestration paths.

Current version: 0.20.0

What is already real:

• live planner integration
• specialist execution
• write gating
• worktree-based writer execution
• recovery and local commit flows
• review and publish inspection
• GitHub confirmation actions
• session persistence
• timeline-first UI

What is still evolving:

• richer agent streaming semantics
• stronger visual polish
• more robust test coverage
• packaging and distribution

Verification

• swift build passes in the current environment
• swift test is still blocked here because this machine is using Command Line Tools without full XCTest / xcodebuild

Repository structure

Sources/CodexOpsStudioApp/   App shell, orchestration, runners, UI
Tests/CodexOpsStudioAppTests/ State and behavior tests
docs/adr/                   Architecture decisions
docs/plans/                 Design and implementation phases
assets/                     Repository visual assets

Open-source docs

• CHANGELOG.md
• CONTRIBUTING.md
• CODE_OF_CONDUCT.md
• SECURITY.md
• LICENSE

Contributing

Issues and pull requests are welcome.

If you want to contribute, please start with:

1. reading CONTRIBUTING.md
2. checking the current roadmap and open issues
3. opening an issue before large changes

Design and architecture references

• docs/adr/0001-use-native-swift-main-window-application.md
• docs/adr/0002-use-dynamic-agent-orchestration.md
• docs/adr/0003-use-single-repository-worktrees-for-write-agents.md
• docs/plans/2026-03-15-codex-ops-studio-design.md

Roadmap

• Better streaming event summarization for orchestrator and specialists
• Stronger review ergonomics and richer diff presentation
• Improved onboarding for repository setup and Codex CLI checks
• Better packaging for public release
• More automated testing once full Xcode test support is available

License

Released under the MIT License.