How dimetron/pi-go works
pi-go is a terminal-based coding agent with a reusable Go runtime and a VS Code chat integration. Its principal workflow is user input through the CLI and agent to an LLM provider; tool calls use project-confined tools, and results return to the interactive TUI. Sessions, Memory Palace, and LSP support that workflow. The README documents additional integrations and capabilities included here. Source excerpts are limited, so edges for unsampled subsystems rely on README statements rather than inferred call chains.
Main entry points: cli.go CLI · agent.go Agent runtime · controller.ts Chat controller · extension.ts VS Code host
Components 30
Agent runtime
- CLI
internal/cli/cli.go - Interactive TUI
internal/tui/tui.go - Agent runtime
internal/agent/agent.go - LLM providers
internal/provider/provider.go - Sandboxed tools
internal/tools/registry.go - Subagents
internal/subagent/orchestrator.go
Project context
- Session store
internal/session/store.go - Memory Palace
internal/palace/palace.go - Palace storage
internal/palace/sqlite_store.go - LSP integration
internal/lsp/manager.go
Interfaces and extensions
- Hooks, skills, MCP
internal/extension/skills.go - Plugin marketplaces
internal/plugin/install.go - Skills audit
internal/audit/scanner.go - Editor RPC
internal/pirpc/rpc.go - ACP server
internal/acp/server/agent.go - A2A server
internal/a2a/server/server.go - Web server
internal/webserver/server.go
VS Code integration
- VS Code host
vscode/src/extension.ts - Host-webview protocol
vscode/src/shared/protocol.ts - Webview entry
vscode/src/webview/main.ts - Chat controller
vscode/src/webview/controller.ts - Prompt composer
vscode/src/webview/composer.ts - Markdown renderer
vscode/src/webview/markdown.ts - Mermaid renderer
vscode/src/webview/mermaid.ts - Tool cards
vscode/src/webview/toolCard.ts - Webview icons
vscode/src/webview/icons.ts - Clipboard actions
vscode/src/webview/clipboard.ts - Diff display
vscode/src/shared/diff.ts - Session browser
vscode/src/sessionsTree.ts
Other components
- User
Connections 30
- User → CLI: enters prompt
README.md - CLI → Agent runtime: dispatches input
README.md - Agent runtime → LLM providers: requests completion
README.md - Agent runtime → Sandboxed tools: invokes tools
README.md - Sandboxed tools → User: returns result
README.md - Agent runtime → Interactive TUI: returns response
README.md - Agent runtime → Session store: persists events
README.md - Agent runtime → Memory Palace: uses memory
README.md - Memory Palace → Palace storage: stores memory
README.md - Agent runtime → LSP integration: uses diagnostics
README.md - Agent runtime → Subagents: dispatches tasks
README.md - CLI → Hooks, skills, MCP: configures extensions
README.md - CLI → Plugin marketplaces: manages plugins
README.md - CLI → Skills audit: runs security scan
README.md - CLI → Editor RPC: serves editor RPC
README.md - CLI → ACP server: starts ACP server
README.md - CLI → A2A server: starts A2A server
internal/a2a/server/server.go - CLI → Web server: starts web server
README.md - VS Code host → Host-webview protocol: exchanges messages
vscode/src/shared/protocol.ts - Webview entry → Host-webview protocol: routes messages
vscode/src/webview/main.ts - Webview entry → Chat controller: creates controller
vscode/src/webview/main.ts - Chat controller → Prompt composer: uses composer
vscode/src/webview/controller.ts - Chat controller → Markdown renderer: renders markdown
vscode/src/webview/controller.ts - Chat controller → Mermaid renderer: renders diagrams
vscode/src/webview/controller.ts - Chat controller → Tool cards: renders tool cards
vscode/src/webview/controller.ts - Chat controller → VS Code host: posts prompts
vscode/src/webview/controller.ts - Tool cards → Diff display: formats diffs
vscode/src/webview/toolCard.ts - Tool cards → Clipboard actions: uses clipboard
vscode/src/webview/toolCard.ts - Chat controller → Webview icons: uses icons
vscode/src/webview/controller.ts - VS Code host → Session browser: browses sessions
README.md