How gitlawb/openclaude works
OpenClaude is a terminal-first coding-agent CLI spanning local and hosted model providers. The principal workflow takes a user prompt, builds system context, runs model/tool interactions, streams results, and persists conversation history. Supporting capabilities include provider setup, agents and tasks, MCP and plugins, and session resume. The QueryEngine excerpts establish its context, input-processing, and transcript-storage calls; other subsystem links reflect README-described capabilities, not inspected call sites.
Main entry points: QueryEngine.ts Query engine · commands.ts Slash commands · App.tsx Terminal app · PromptInput.tsx Prompt input
Components 17
Terminal interaction
- Terminal app
src/components/App.tsx - Prompt input
src/components/PromptInput/PromptInput.tsx - Slash commands
src/commands.ts
Agent runtime
- Query engine
src/QueryEngine.ts - System context
src/utils/queryContext.ts - Tool execution
src/Tool.ts - Task workflows
src/Task.ts - Worker agents
src/coordinator/workerAgent.ts
Extensibility
- MCP setup
src/commands/mcp - Plugin management
src/commands/plugin
Model providers
- Provider manager
src/components/ProviderManager.tsx - Model backend
Session and settings
- Transcript storage
src/utils/sessionStorage.ts - Portable session tools
src/utils/sessionStoragePortable.ts - Provider settings
Other components
- CLI user
- Cloud or local model
Connections 18
- CLI user → Terminal app: starts CLI
- CLI user → Prompt input: enters prompt
- Terminal app → Prompt input: presents
- Terminal app → Slash commands: dispatches
- Prompt input → Query engine: submits prompt
- Query engine → System context: fetches context
- Query engine → Tool execution: runs interactions
- Query engine → Transcript storage: records history
- Query engine → Model backend: selects model
- Model backend → Cloud or local model: sends requests
- Query engine → Worker agents: provides agent definitions
- Query engine → Task workflows: supports task workflows
- Slash commands → Provider manager: opens setup
- Provider manager → Provider settings: updates profiles
- Slash commands → MCP setup: configures MCP
- Slash commands → Plugin management: manages plugins
- Portable session tools → Transcript storage: supports session reads
- Transcript storage → Terminal app: restores history