Skip to content

v0.1.0

Choose a tag to compare

@github-actions github-actions released this 03 May 14:54
· 35 commits to main since this release

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 localjk auth login once, token stored in ~/.config/jk/config.yml. Scripts and AI agents call jk without ever seeing the credential.
  • Zero-config job detection.jk.ymlgit remote origin → directory name. cd repo && jk status Just 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 --host flag 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@latest

Or 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.