How hunters-sec/opencode works
OpenWorm is an AI coding agent with terminal, web, and desktop clients backed by an OpenCode server. The main workflow is selecting a provider/model, creating or continuing a coding session, and using the agent’s tools to work with a project. The README also documents read-only planning, multi-provider support, and WormGPT models. Edges below are limited to relationships shown in the excerpts or README; several listed subsystems were not sampled, so their internal wiring is omitted.
Main entry points: server.ts HTTP server · app.tsx Terminal UI · handler.ts Hosted model gateway · instance.ts Project context
Components 23
User clients
- Terminal UI
packages/opencode/src/cli/cmd/tui/app.tsx - Web app
packages/app/src/app.tsx - Web SDK adapter
packages/app/src/utils/server.ts - Desktop client
packages/desktop/src/entry.tsx - Session review UI
packages/ui/src/components/session-review.tsx - Review tab
packages/app/src/pages/session/review-tab.tsx
Agent runtime
- HTTP server
packages/opencode/src/server/server.ts - Session routes
packages/opencode/src/server/routes/session.ts - Agent engine
packages/opencode/src/agent/agent.ts - Prompt history
packages/opencode/src/cli/cmd/tui/component/prompt/history.tsx - Runtime flags
packages/opencode/src/flag/flag.ts
Project services
- Project context
packages/opencode/src/project/instance.ts - Project model
packages/opencode/src/project/project.ts - Local storage
packages/opencode/src/storage/storage.ts - Filesystem tools
packages/opencode/src/util/filesystem.ts - File matching
packages/opencode/src/util/glob.ts - Runtime logging
packages/opencode/src/util/log.ts
Model access
- Provider registry
packages/opencode/src/provider/provider.ts - Hosted model gateway
packages/console/app/src/routes/zen/util/handler.ts - Anthropic adapter
packages/console/app/src/routes/zen/util/provider/anthropic.ts - OpenAI adapter
packages/console/app/src/routes/zen/util/provider/openai.ts - Compatible adapter
packages/console/app/src/routes/zen/util/provider/openai-compatible.ts
Other components
- Developer
Connections 23
- Developer → Terminal UI: uses
README.md - Developer → Web app: uses
README.md - Developer → Desktop client: uses
README.md - Terminal UI → HTTP server: calls API
- Web app → Web SDK adapter: configures client
- Web SDK adapter → HTTP server: calls API
- Desktop client → HTTP server: uses backend
README.md - HTTP server → Session routes: routes requests
packages/opencode/src/server/server.ts - HTTP server → Provider registry: uses providers
packages/opencode/src/server/server.ts - HTTP server → Agent engine: uses agents
packages/opencode/src/server/server.ts - Terminal UI → Prompt history: renders
packages/opencode/src/cli/cmd/tui/app.tsx - Terminal UI → Provider registry: selects models
README.md - HTTP server → Project context: uses context
packages/opencode/src/server/server.ts - Project context → Project model: uses state
packages/opencode/src/project/instance.ts - Project context → Local storage: persists data
- Local storage → Filesystem tools: reads and writes
packages/opencode/src/storage/storage.ts - Filesystem tools → File matching: uses matching
packages/opencode/src/util/filesystem.ts - HTTP server → Runtime logging: logs activity
packages/opencode/src/server/server.ts - Review tab → Session review UI: renders
- Developer → Hosted model gateway: requests hosted models
README.md - Hosted model gateway → Anthropic adapter: dispatches
packages/console/app/src/routes/zen/util/handler.ts - Hosted model gateway → OpenAI adapter: dispatches
packages/console/app/src/routes/zen/util/handler.ts - Hosted model gateway → Compatible adapter: dispatches
packages/console/app/src/routes/zen/util/handler.ts