LaunchKit · 2026
Back to Skills

agentcli-go

agentcli-go framework reference for building Go CLI tools.

0
314 downloads
by @gh-xj

Setup & Installation

openclaw skills install @gh-xj/agentcli-go

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install agentcli-go

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

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: scaffold a new Go CLI tool named my-tool with a sync command

AGENT
  1. 1Run `agentcli new --name my-tool --module github.com/me/my-tool` to generate the project skeleton
  2. 2Review generated files: main.go, cmd/root.go, internal/app/, internal/config/, Taskfile.yml
  3. 3Run `agentcli add command --name sync --preset file-sync` to add the sync subcommand
  4. 4Wire configx.Load in internal/config/load.go with defaults, env prefix, and flag overrides
  5. 5Run `task ci` to confirm lint, tests, build, and smoke checks all pass
OUTPUT

A fully structured Go CLI project with the sync command wired and CI passing