What you need

• Node.js 22.14 or newer
• ZeroClaw on your PATH (npm i -g zeroclaw@latest), then run its onboard / model setup so zeroclaw works
• Jira API token: Atlassian → Security → API tokens
• Tempo API token from your Tempo / Atlassian admin (same kind of bearer token you use for Tempo Cloud API)

Install

npm i -g jiraclaw

From this repo (for development):

npm install && npm run build && npm link

Env vars that jiraclaw config does not set

jiraclaw config only saves Jira base URL, Tempo base URL, and (optional) encrypted Jira/Tempo tokens under ~/.jiraclaw/. It does not set your Jira login email or the passphrase for the encrypted file. Those have to come from the environment (or a .env file in the folder where you run the command — jiraclaw loads .env from current working directory).

Put these in ~/.zshrc, ~/.bashrc, or export them in the terminal before you run jiraclaw:

export JIRA_EMAIL="[email protected]"

If you use jiraclaw config set-jira-token or set-tempo-token, you must also set a passphrase (same value every time you run jiraclaw so it can read the encrypted file):

export JIRACLAW_SECRET="choose-a-long-passphrase-and-do-not-share-it"

If zeroclaw is not on your PATH or you use a custom name/path:

export ZEROCLAW_BIN="/full/path/to/zeroclaw"

Optional overrides (env wins over values saved by jiraclaw config):

export JIRA_BASE_URL="https://your-site.atlassian.net"
export JIRA_API_TOKEN="..."
export TEMPO_BASE_URL="https://api.tempo.io/4"
export TEMPO_API_TOKEN="..."

After editing your shell config, run source ~/.zshrc (or open a new terminal).

Saving URLs and tokens with jiraclaw (optional)

Only works if JIRACLAW_SECRET is exported (see above).

jiraclaw config set-jira-url https://your-site.atlassian.net
jiraclaw config set-tempo-url https://api.tempo.io/4
jiraclaw config set-jira-token YOUR_JIRA_API_TOKEN
jiraclaw config set-tempo-token YOUR_TEMPO_TOKEN

Tokens are stored encrypted; jiraclaw does not print them back.

Commands

jiraclaw

Opens the interactive menu.

jiraclaw today
jiraclaw search 'assignee = currentUser() AND updated >= -7d'

English-style commands (ZeroClaw plans the steps; you get confirmations before Tempo writes):

jiraclaw add today's hours in tempo
jiraclaw log my work
jiraclaw create jira task for API cleanup
jiraclaw update ABC-123 status to In Progress

License

MIT