Open-source CLI exploration
ImgFlow.
Small commands. Useful transformations.
Exploring palette conversion and image-processing workflows through a Go command-line tool.
Public repository · upstream lineage retained

Start with the friction.
Image operations often require opening a separate application, repeating settings, and manually moving files. A command-line interface makes repeated transformations easier to compose.
Why it matters
A command is useful when its inputs and outputs are predictable. Pipes and file destinations let image processing fit into an existing workflow.
What the work contains.
This is my public image-tooling repository. It retains the github.com/Achno/gowall module, command names, and Achno’s MIT copyright. It is presented as an exploration/adaptation of that lineage, not as software I originated alone or evidence of Go expertise.
Give each part a job.
- 01
Parse an explicit command
Cobra subcommands describe conversion, effects, compression, extraction, and other operations. Shared flags define file, batch, directory, and output behavior.
- 02
Transform the input
Image processors implement the transformation while the I/O layer manages formats, input paths, and destinations. The checked-in source still uses the Gowall command name.
- 03
Return a reusable artifact
The palette comparison on this site uses files produced by the actual checked-out CLI from a generated color-card fixture, rather than a CSS filter pretending to be CLI output.
Boundaries are part of the design.
A broad CLI has different dependencies and failure modes for different features. The local visual example exercises one command only; it does not validate every OCR provider, compression path, or platform installer.
Evidence before confidence.
Built the checked-out CLI with Go 1.27.2 and ran the palette conversion with exit status 0. The input and output are distinct, valid 720 × 480 PNGs; their SHA256 values and exact command are recorded in the downloadable transcript. This validates that one conversion, not the entire feature set.
Evidence reviewed on 18 October 2026 at the source revision linked below. Local checks do not establish production readiness.
There’s a next iteration.
Public repository · upstream lineage retained. Make upstream provenance and naming consistent, add focused input/output regression fixtures, and improve error messages before expanding the surface of the CLI.
Read past the story.
The source links point to the exact revision reviewed, rather than a moving branch.
- Upstream attribution
LICENSE - Module identity
go.mod - CLI commands
cmd/root.go - Palette conversion
cmd/convert.go