UniGo is a fast, flexible, and enterprise-grade Golang CLI template inspired by UniRTM and helloworld. It provides a robust foundation for building modern command-line applications in Go, featuring beautiful terminal output, structured logging, built-in caching, and a comprehensive CI/CD pipeline.
- Modern CLI Architecture: Built with Go 1.24+ and Cobra, providing a structured and extensible command-line application framework.
- Beautiful Output: Utilizes
ptermfor rich, colorful, and interactive terminal output. - Structured Logging: Built-in support for Go's standard
slogpackage for high-performance structured logging. - Robust Tooling: Includes built-in commands like
doctor,self-update,cache,config, andlicense. - Triple Guarantee Quality: 100% code purity enforced through IDE checks, Pre-commit hooks, and GitHub Actions integrated quality gates.
- Cross-Platform Ready: Runs seamlessly on macOS, Linux, and Windows.
UniGo is engineered to solve the boilerplate problem when starting new Go CLI projects. It standardizes the development environment, architectural patterns, and automation pipelines out of the box.
- CLI Framework: Utilizes
spf13/cobraandspf13/viperfor powerful command parsing and configuration management. - UI & Logging: Integrated
ptermfor UI components andslogfor structured event logging. - Database & Caching: SQLite-backed (via
modernc.org/sqlite) local caching and transactional data storage. - Task Orchestration: Configured with
UniRTMfor managing local development workflows (lint, test, verify).
- Runtime: Go (>= 1.24).
- Git: Global git installation required.
- UniRTM: Required for task execution and orchestration.
Via NPM:
npm install -g @snowdreamtech/unigoVia PyPI:
pip install snowdreamtech-unigo- Install UniRTM: Ensure
unirtmis installed on your system. - Initialize:
unirtm run setup(bootstraps core dependencies and hooks). - Install:
unirtm run install(installs project dependencies). - Verify:
unirtm run verify(ensures everything is green). - Build:
go build -o unigo main.go
unigo version: Print the version numberunigo doctor: Check system health and diagnose issuesunigo self-update: Update to the latest versionunigo cache: Manage local cacheunigo config: Manage configurationunigo license: Manage copyright license headers
- Run
unirtm run verifyto ensure all quality gates are green (runs formatters, linters, tests, and security audits). - Ensure
CHANGELOG.mdis updated.
- Problem:
unirtm run verifyfails with test errors.- Solution: Ensure your code passes all Go unit tests. UniGo enforces strict coverage and race condition checks.
- Problem: Pre-commit hooks fail.
- Solution: The hooks often auto-fix issues (like formatting). Stage the modified files and commit again.
- Audit Logging: All critical operations and security scans are executed during the
verifytask using tools liketrivy,gitleaks, andgovulncheck. - Dependency Management: Powered by Dependabot to ensure all dependencies are kept up-to-date and secure.
git clone https://github.com/snowdreamtech/UniGo.git
cd UniGo
unirtm run setup
unirtm run installThe GITHUB_PROXY (default: https://gh-proxy.sn0wdr1am.com/) is optimized for specific network acceleration scenarios. Misusing it for unsupported protocols (like Git) will result in errors.
| Scenario | Supported? | Example / Note |
|---|---|---|
| Release Files | ✅ Yes | .../releases/download/v1.0/tool.zip |
| Source Archives | ✅ Yes | .../archive/master.zip or .tar.gz |
| Direct File Links | ✅ Yes | .../blob/master/filename |
| Git Clone | ❌ No | Do not use for git clone or insteadOf configs. |
| Project Folders | ❌ No | Browsing/cloning via proxy is not supported. |
Important
To prevent breaking toolchains (like unirtm), this template explicitly disables Git redirection via this proxy. Use it only for direct HTTP downloads in scripts.
This project is licensed under the MIT License. Copyright (c) 2026-present SnowdreamTech Inc. See the LICENSE file for the full license text.