Releases: ysmaoui/jkit
Release list
v0.6.0
v0.5.0
v0.4.0
v0.3.0
v0.2.0
Renamed: jk → jkit.
The previous binary name collided with avivsinai/jenkins-cli, which also ships a jk binary. Renaming early to avoid muddying the conversation for anyone trying to install one or the other.
Breaking changes
| Before | After |
|---|---|
Binary jk |
Binary jkit |
Module github.com/ysmaoui/jk |
Module github.com/ysmaoui/jkit |
Per-repo config .jk.yml |
Per-repo config .jkit.yml |
XDG dir ~/.config/jk/ |
XDG dir ~/.config/jkit/ |
Env vars JK_* (e.g. JK_PIPELINE_SOURCE, JK_CONFIG_DIR) |
JKIT_* |
Old config will not be picked up. Re-run jkit auth login or move the file:
mv ~/.config/jk ~/.config/jkit
mv .jk.yml .jkit.yml # in any repos that had oneAlso in this release
- Documented PGV-first pipeline backend explicitly, including non-use of the older
pipeline-rest-api(/wfapi/) plugin and the Blue Ocean fallback path. See docs/configuration.md and docs/DESIGN.md.
Install
go install github.com/ysmaoui/jkit@latestOr grab a pre-built binary below — Linux, macOS, Windows on amd64 and arm64. Then jkit auth login.
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.