Xedoc

Xedoc is a macOS workspace UI for browsing Codex conversations, plans, diffs, reviews, and project context in one place.

Xedoc 是一个面向 macOS 的 Codex 工作台，用来集中查看会话、计划、代码 diff、review 结果和项目上下文。

Overview | 项目简介

Xedoc wraps local Codex runtime and session storage with a desktop interface built in SwiftUI. It is designed for code-focused workflows: reviewing recent changes, following long conversations, inspecting command activity, and iterating on implementation inside a project workspace.

Xedoc 基于本地 Codex 运行时和会话存储，提供一套 SwiftUI 桌面界面，重点服务于代码工作流：查看最近改动、跟踪长会话、检查命令活动，以及在项目工作区里持续迭代实现。

Highlights | 主要功能

• Workspace-based conversation browser with project and thread organization

• Transcript UI with user / assistant / command / diff / review rendering

• Review summary panels for changed files, additions, deletions, and undo flows

• Diff viewer with horizontal scrolling, sticky line numbers, and syntax highlighting

• Composer with attachments, queue controls, inline editing, and drag-to-attach

• Live external storage sync for Codex session data

• Inspector panes for review, comments, terminal, automations, and utility pages

• 按工作区组织的会话与线程浏览

• 支持 user / assistant / command / diff / review 的 transcript 展示

• 改动文件、增删统计、undo 等 review 汇总面板

• 支持横向滚动、固定行号、语法高亮的 diff 视图

• 支持附件、请求队列、原位编辑、拖拽添加的输入区

• 对 Codex 会话存储的外部变更同步

• review、comments、terminal、automations、utility 等检查面板

Tech Stack | 技术栈

• Swift 6.2
• SwiftUI on macOS 15+
• Swift Package Manager
• SwiftTerm
• Textual
• HighlightSwift
• Vendored MarkdownUI

Dependencies | 依赖库

• SwiftTerm: terminal rendering and terminal session UI

• Textual: attributed text and markdown-adjacent text rendering support

• HighlightSwift: syntax highlighting for code and diff content

• MarkdownUI: vendored markdown rendering base, customized inside Vendor/MarkdownUI

• SwiftTerm：终端渲染与终端会话界面

• Textual：富文本与文本渲染支持

• HighlightSwift：代码与 diff 的语法高亮

• MarkdownUI：已 vendored 到仓库内，并在 Vendor/MarkdownUI 中做了定制

Project Structure | 目录结构

Sources/
  PastureCore/         Core models, parsing, layout rules, presentation derivation
  PastureAppFeature/   App scenes, UI primitives, runtime wiring, desktop behaviors
  Xedoc/               App entry point
Tests/
  PastureCoreTests/        Core presentation and behavior tests
  PastureAppFeatureTests/  App feature and interaction tests
Vendor/
  MarkdownUI/         Vendored Markdown rendering dependency

Getting Started | 本地运行

Requirements | 环境要求

• macOS 15 or later
• Xcode 16+ or a Swift 6.2 toolchain

Build | 构建

swift build

Test | 测试

swift test

Run the app | 启动应用

Open the package in Xcode and run the Xedoc target, or build the executable target from SwiftPM if your environment is configured for app execution.

在 Xcode 中打开项目并运行 Xedoc target；如果本地 SwiftPM 环境已配置好 app 执行链，也可以直接构建对应可执行目标。

Status | 当前状态

This repository is under active iteration. UI structure, runtime integration, and workflow affordances are still evolving.

这个仓库目前处于持续迭代中，界面结构、运行时集成和工作流体验仍在不断调整。