v0.1.0
First public release.
jk is a small terminal CLI for the everyday Jenkins dev loop — trigger builds, tail logs, diagnose failures, lint Jenkinsfiles. Think gh for Jenkins. Not an admin tool.
It exists because I wanted to give an AI coding agent a feedback loop on Jenkins (did the change build? what failed? why?) without handing it credentials. jk auth login once, token lives in ~/.config/jk/config.yml, the agent just calls jk. Turns out the same ergonomics are nice for humans.
Highlights
- Auth stays local —
jk auth loginonce, token stored in~/.config/jk/config.yml. Scripts and AI agents calljkwithout ever seeing the credential. - Zero-config job detection —
.jk.yml→git remote origin→ directory name.cd repo && jk statusJust Works. - Paste any Jenkins URL — classic or Blue Ocean. Host, job path, and build number are extracted automatically.
jk diagnose URL— one-shot failure summary: failed stage, error excerpts, params, triggering commits.- JSON output everywhere (
--json), Go templates (--format), scriptable. - Multi-host via
--hostflag and config aliases. - AI agent integration — drop-in skill / slash command / sub-agent for Claude Code under
agents/.
Install
go install github.com/ysmaoui/jk@latestOr grab a pre-built binary below — Linux, macOS, Windows on amd64 and arm64. Then jk auth login.
Expect breaking changes before v1.0. Issues, ideas, and PRs welcome.