|
|
@@ -0,0 +1,26 @@
|
|
|
+# TUI Agent Guidelines
|
|
|
+
|
|
|
+## Build/Test Commands
|
|
|
+
|
|
|
+- **Build**: `go build ./cmd/opencode` (builds main binary)
|
|
|
+- **Test**: `go test ./...` (runs all tests)
|
|
|
+- **Single test**: `go test ./internal/theme -run TestLoadThemesFromJSON` (specific test)
|
|
|
+- **Generate client**: `go generate ./pkg/client/` (after server endpoint changes)
|
|
|
+- **Release build**: Uses `.goreleaser.yml` configuration
|
|
|
+
|
|
|
+## Code Style
|
|
|
+
|
|
|
+- **Language**: Go 1.24+ with standard formatting (`gofmt`)
|
|
|
+- **Imports**: Group standard, third-party, local packages with blank lines
|
|
|
+- **Naming**: Go conventions - PascalCase exports, camelCase private, ALL_CAPS constants
|
|
|
+- **Error handling**: Return errors explicitly, use `fmt.Errorf` for wrapping
|
|
|
+- **Structs**: Define clear interfaces, embed when appropriate
|
|
|
+- **Testing**: Use table-driven tests, `t.TempDir()` for file operations
|
|
|
+
|
|
|
+## Architecture
|
|
|
+
|
|
|
+- **TUI Framework**: Bubble Tea v2 with Lipgloss v2 for styling
|
|
|
+- **Client**: Generated OpenAPI client communicates with TypeScript server
|
|
|
+- **Components**: Reusable UI components in `internal/components/`
|
|
|
+- **Themes**: JSON-based theming system with override hierarchy
|
|
|
+- **State**: Centralized app state with message passing
|
adamdottv