How roketskiy/fintwind works
Fintwind is a native Windows desktop client for OpenCode 2. The main workflow is a user managing project sessions, composing a prompt, and following the agent’s streamed activity; the desktop delegates provider execution to a separate authenticated daemon. The README documents this process boundary and the major product features. Source excerpts are partial, so feature branches are included where README capabilities and tree paths support them, while unverified internal call chains are omitted.
Main entry points: app.rs GPUI application · server.rs Daemon request server · opencode.rs OpenCode integration · client.rs Daemon client
Components 26
Desktop experience
- GPUI application
src/app.rs - Session tabs
src/app/sessions.rs - Prompt composer
src/app/composer.rs - Activity transcript
src/app/transcript_view.rs - Markdown rendering
src/md/render.rs - Appearance settings
src/app/settings.rs - Theme system
src/theme.rs - Browser panel
src/browser.rs - Built-in terminal
src/terminal.rs - Usage statistics UI
src/app/usage_page.rs - MCP management UI
src/app/mcp_page.rs
Agent runtime
- Daemon client
crates/fintwind-client/src/client.rs - Desktop driver proxy
src/driver/mod.rs - Daemon process
crates/fintwind-daemon/src/main.rs - Daemon request server
crates/fintwind-core/src/server.rs - WebSocket contract
crates/fintwind-protocol/src/protocol.rs - OpenCode integration
crates/fintwind-core/src/driver/opencode.rs - OpenCode sessions
crates/fintwind-core/src/opencode_session.rs
Workspace tools
- Files and Git UI
src/app/file_search.rs - Git history
src/app/git_history.rs - Workspace and Git
crates/fintwind-core/src/workspace.rs
Local services
- Local persistence
crates/fintwind-core/src/persistence.rs - Attachment handling
crates/fintwind-core/src/attachments.rs
Other components
- Desktop user
- OpenCode CLI
- Configured model provider
Connections 25
- Desktop user → GPUI application: uses
README.md - GPUI application → Session tabs: manages sessions
README.md - GPUI application → Prompt composer: composes prompts
README.md - GPUI application → Activity transcript: shows activity
README.md - Activity transcript → Markdown rendering: renders replies
- GPUI application → Appearance settings: configures appearance
README.md - Appearance settings → Theme system: selects themes
- GPUI application → Browser panel: opens optional panel
README.md - GPUI application → Built-in terminal: opens terminal
README.md - GPUI application → Files and Git UI: browses files
README.md - GPUI application → Git history: views history
README.md - GPUI application → Usage statistics UI: explores usage
README.md - GPUI application → MCP management UI: manages MCP
README.md - GPUI application → Daemon client: communicates through
README.md - Daemon client → Daemon process: sends authenticated requests
README.md - Daemon process → Daemon request server: serves requests
README.md - Daemon request server → WebSocket contract: uses contract
README.md - Desktop driver proxy → Daemon client: forwards commands
src/driver/mod.rs - Daemon request server → OpenCode integration: dispatches agent work
- OpenCode integration → OpenCode CLI: integrates with
README.md - OpenCode CLI → Configured model provider: uses configured providers
README.md - OpenCode integration → OpenCode sessions: uses session helpers
crates/fintwind-core/src/driver/opencode.rs - Daemon request server → Workspace and Git: handles workspace operations
- Daemon request server → Local persistence: uses local storage
README.md - Prompt composer → Attachment handling: attaches files
README.md