How acrognale/pasture works
Pasture is a Tauri desktop GUI for Codex, with a web transcript-sharing viewer. The primary workflow is composing a prompt, running and viewing a Codex conversation, then reviewing its output and optionally sending consolidated feedback. Conversation branching, handoff/read-thread, approvals, workspace tools, and generated titles are additional product capabilities. The graph includes the native command layer and sharing backend; source excerpts were limited, so uncertain implementation wiring is omitted.
Main entry points: ConversationPane.tsx Conversation pane · renderer.tsx Desktop UI · registry.rs Native commands · s.$id.tsx Shared transcript
Components 24
Desktop shell
- Desktop UI
apps/desktop/src/renderer.tsx - Workspace
apps/desktop/src/workspace/WorkspaceProvider.tsx
Conversation workflow
- Prompt composer
apps/desktop/src/composer/components/ComposerBar.tsx - Conversation pane
apps/desktop/src/conversation/ConversationPane.tsx - Conversation state
apps/desktop/src/conversation/store/store.ts - Message sending
apps/desktop/src/conversation/hooks/useSendMessage.ts - Codex client
apps/desktop/src/codex/client.ts - Transcript rendering
apps/desktop/src/conversation/components/ConversationTranscriptSection.tsx - Thread management
apps/desktop/src-tauri/src/commands/threads.rs - Handoff and read
apps/desktop/src-tauri/src/handoff.rs - Approval handling
apps/desktop/src/approvals/hooks/useApprovals.ts
Review and feedback
- Diff review
apps/desktop/src/review/RepoReviewPane.tsx - Turn review
apps/desktop/src/review/TurnReviewContext.tsx - Message comments
apps/desktop/src/conversation/comments/hooks.ts
Native services
- Native commands
apps/desktop/src-tauri/src/commands/registry.rs - Local database
apps/desktop/src-tauri/src/db/init.rs - Title generation
apps/desktop/src-tauri/src/title_generation.rs
Transcript sharing
- Sharing API
apps/web/src/routes/api.share.tsx - Share database
apps/web/src/lib/db.ts - Shared transcript
apps/web/src/routes/s.$id.tsx - Web viewer
apps/web/src/components/transcript/TranscriptView.tsx
Other components
- Developer
- Codex runtime
- Public reader
Connections 24
- Developer → Desktop UI: uses
- Desktop UI → Workspace: opens
- Workspace → Conversation pane: selects thread
- Developer → Prompt composer: composes prompt
- Prompt composer → Message sending: submits
- Message sending → Codex client: sends request
- Codex client → Codex runtime: communicates
- Codex runtime → Codex client: streams events
- Conversation pane → Conversation state: reads state
- Conversation state → Transcript rendering: provides turns
- Conversation pane → Thread management: manages threads
- Conversation pane → Handoff and read: requests context
- Conversation pane → Approval handling: shows approvals
- Conversation pane → Diff review: opens review
- Diff review → Turn review: selects turn range
- Conversation pane → Message comments: annotates messages
- Desktop UI → Native commands: invokes commands
- Native commands → Local database: persists state
- Native commands → Title generation: generates titles
- Developer → Sharing API: shares transcript
- Sharing API → Share database: stores share
- Public reader → Shared transcript: opens link
- Shared transcript → Share database: loads transcript
- Shared transcript → Web viewer: renders transcript