Thanks for your interest in contributing! This guide will help you get started.
git clone https://github.com/yanmxa/gencode.git
cd gencode
go build -o gen ./cmd/gen
./gen- Go 1.21+
- An LLM API key (Anthropic, OpenAI, or Google)
cmd/gen/ # CLI entry point
internal/
├── provider/ # LLM providers (anthropic, openai, google)
├── tool/ # Built-in tools (read, write, edit, bash, etc.)
├── tui/ # Terminal UI (Bubble Tea)
├── mcp/ # MCP protocol support
├── config/ # Settings and permissions
└── system/ # System prompt generation
go test ./...GEN_DEBUG=1 ./gen
# Logs written to ~/.gen/debug.logOpen an issue with:
- Steps to reproduce
- Expected vs actual behavior
- OS, Go version, and provider used
Open an issue describing:
- The problem you're solving
- Your proposed solution
- Alternative approaches considered
- Fork the repo
- Create a branch:
git checkout -b feature/your-feature - Make changes and test
- Commit with sign-off:
git commit -s -m "feat: add feature" - Push and open a PR
Follow Conventional Commits:
feat: add new feature
fix: resolve bug
docs: update documentation
refactor: restructure code
test: add tests
chore: maintenance tasks
| Area | Description |
|---|---|
| Providers | Add new LLM providers (Ollama, Mistral, etc.) |
| Tools | Create new built-in tools |
| MCP | Improve MCP server support |
| TUI | Enhance terminal UI/UX |
| Docs | Improve documentation |
| Tests | Increase test coverage |
Be respectful and constructive. We welcome contributors of all backgrounds and experience levels.
Open an issue or start a discussion. We're happy to help!