jenkins-cli

oasis-jenkins — an AXI-compliant CLI for the Oasis Jenkins CI server. List jobs and folders, read build history, inspect build results and parameters, tail console logs, and trigger builds — with token-efficient TOON output built for autonomous agents.

Extracted from the oasis-core Claude Code plugin so it can be installed, versioned, and released on its own.

Quick Start

Install the jenkins-cli skill in the Agent Skills format with npx skills:

npx skills add oasissys/jenkins-cli --skill jenkins-cli -g

That is the entire setup — the skill teaches your agent the CLI, and it runs without a global install as npx -y @oasissys/jenkins-cli (Node 20+ required). Installing the skill itself needs GitHub access to this private repo.

-g installs the skill for all projects (~/.claude/skills/); drop it to install for the current project only.

Other ways to install

Zero setup

Any capable agent can run the CLI directly with nothing installed. Just tell your agent:

Execute `npx -y @oasissys/jenkins-cli` to get Oasis Jenkins tools.

Global install + session hook

Want the CLI on PATH and Jenkins job status fed into every agent session?

npm install -g @oasissys/jenkins-cli   # installs `oasis-jenkins` (and the `jenkins-cli` alias)
oasis-jenkins setup

setup registers a SessionStart hook for Claude Code, Codex, and OpenCode that surfaces Jenkins job status at session start — restart your agent session after running it. If you use the oasis-core Claude Code plugin, it already ships this hook; skip setup or remove one of the two.

From a clone (development)

pnpm install && pnpm run build && pnpm link --global

Authenticate

Credentials live in ~/.oasis.json (shared with the other oasis CLIs and the Oasis dashboard) and are verified against the live server before being saved.

oasis-jenkins auth --user <username> --password <token>
oasis-jenkins auth            # show current status
oasis-jenkins auth --clear    # sign out

Use

oasis-jenkins                                        # live view: top-level jobs and their status
oasis-jenkins jobs --folder OasisPlus                # jobs inside a folder
oasis-jenkins views                                  # list views
oasis-jenkins job "OasisPlus/backend"                # job status + recent builds
oasis-jenkins build "OasisPlus" lastFailedBuild      # one build's result and parameters
oasis-jenkins console "OasisPlus" 42 --tail 50       # console log (tail by default, --full for all)
oasis-jenkins params "OasisPlus/excel-service"       # build parameter form (choices + defaults)
oasis-jenkins trigger "Deploy" --param ENV=staging   # start a build

Every command supports --help. Output is TOON on stdout, diagnostics on stderr, exit codes 0/1/2 (success/error/usage).

Development

pnpm run dev -- jobs --folder OasisPlus   # run from source
pnpm test                                  # vitest
pnpm run lint                              # eslint
pnpm run build:skill                       # regenerate SKILL.md

Releases are cut by release-please from conventional commits on main. Do not hand-edit CHANGELOG.md, .release-please-manifest.json, or skills/jenkins-cli/SKILL.md — they are generated.