agentcli-go
by gh-xj
Coding Agents & IDEsBrief
agentcli-go framework reference for building Go CLI tools.
Description
What This Skill Does
agentcli-go is a shared Go library that provides scaffolding, command wiring, config loading, and lifecycle hooks for building CLI tools. It exposes a standard project layout, a cobra wrapper (cobrax), and a config precedence system (configx). The module is pre-1.0 and hosted at github.com/gh-xj/agentcli-go.
Bundles cobra setup, zerolog initialization, config precedence logic, and scaffolding into one reusable module so the same patterns don't need to be wired from scratch in each project.
When to Use It
- Scaffolding a new Go CLI project with standard directory layout
- Adding a typed subcommand to an existing CLI tool using a preset
- Loading config from a file, environment variables, and flags with defined precedence
- Running preflight and postflight hooks around a command's main logic
- Diagnosing a CLI project's structure with the doctor check
Example Workflow
User asks: scaffold a new Go CLI tool named my-tool with a sync command
- 1
Run
agentcli new --name my-tool --module github.com/me/my-toolto generate the project skeleton - 2
Review generated files: main.go, cmd/root.go, internal/app/, internal/config/, Taskfile.yml
- 3
Run
agentcli add command --name sync --preset file-syncto add the sync subcommand - 4
Wire configx.Load in internal/config/load.go with defaults, env prefix, and flag overrides
- 5
Run
task cito confirm lint, tests, build, and smoke checks all pass
A fully structured Go CLI project with the sync command wired and CI passing
Installation
clawhub install gh-xj/agentcli-goRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.