AgentToolHub
Skill

bkt

bkt — a Claude Code skill from avivsinai/bitbucket-cli

Features

  • ✓Curated collection of bkt — a claude code skill from avivsinai/bitbucket-cli resources
  • ✓Covers a wide range of tools across multiple categories
  • ✓Community-maintained and regularly updated
  • ✓Browse the [GitHub repository](https://github.com/avivsinai/bitbucket-cli) for the complete list

Installation Guide

Homebrew (macOS/Linux)

bash
brew install avivsinai/tap/bitbucket-cli

Scoop (Windows)

powershell
scoop bucket add avivsinai https://github.com/avivsinai/scoop-bucket
scoop install bitbucket-cli

Go Install

bash
go install github.com/avivsinai/bitbucket-cli/cmd/bkt@latest

This installs bkt to $GOPATH/bin (or $HOME/go/bin by default). Ensure the directory is in your $PATH.

Nix (NixOS / nix-darwin / Linux / macOS)

Run the latest master without installing:

bash
nix run github:avivsinai/bitbucket-cli -- --version

Install into your user profile:

bash
nix profile install github:avivsinai/bitbucket-cli

Pin to a specific tag or commit by appending a ref (e.g. github:avivsinai/bitbucket-cli/v1.2.3).

Note: The Nix package does not embed OAuth client credentials. For Bitbucket Cloud OAuth (bkt auth login --kind cloud --web), set BKT_OAUTH_CLIENT_ID and BKT_OAUTH_CLIENT_SECRET in your environment.

Don't have Nix yet? See nixos.asia/en/install for a quick setup guide (installs Nix with flakes enabled out of the box).

Binary Downloads

Download pre-built binaries for your platform from the releases page.

Bitbucket Pipelines

bkt supports fully config-free headless use via environment variables. Set BKT_TOKEN and BKT_HOST as secured repository variables — no prior bkt auth login or bkt context create step required.

yaml
pipelines:
  default:
    - step:
        name: Open PR
        script:
          - export BKT_VERSION="0.19.0"  # pin to a specific release
          - curl -sL "https://github.com/avivsinai/bitbucket-cli/releases/download/v${BKT_VERSION}/bkt_${BKT_VERSION}_linux_x86_64.tar.gz" | tar xz -C /tmp && install /tmp/bkt /usr/local/bin/
          - bkt pr create --title "Auto PR" --source "$BITBUCKET_BRANCH"

Environment Variables

All bkt behaviour can be configured via environment variables, which is especially useful in containers and CI/CD pipelines.

| Variable | Description |
|---|---|
| BKT_TOKEN | Authentication token. Bypasses keyring storage entirely. |
| BKT_HOST | Bitbucket server base URL (e.g. https://bitbucket.example.com). Required alongside BKT_TOKEN for config-free use. bitbucket.org is auto-detected as Cloud. |
| BKT_USERNAME | Username for basic authentication in headless mode. |
| BKT_AUTH_METHOD | Authentication method: basic or bearer. DC defaults to bearer when BKT_USERNAME is absent; Cloud always uses basic. |
| BKT_PROJECT | Default Data Center project key (headless mode). |
| BKT_WORKSPACE | Default Bitbucket Cloud workspace (headless mode). |
| BKT_REPO | Default repository slug (headless mode). |
| BKT_CONFIG_DIR | Override the config file directory (default: $XDG_CONFIG_HOME/bkt). |
| BKT_HTTP_DEBUG | Set to 1 to log HTTP request URLs and response status codes. |
| BKT_ALLOW_INSECURE_STORE | Set to 1 to use encrypted file fallback when no OS keychain is available. |

Minimal headless example (Data Center):

bash
export BKT_HOST=https://bitbucket.example.com
export BKT_TOKEN=my-personal-access-token
export BKT_PROJECT=MYPROJ
export BKT_REPO=my-service

bkt pr list
bkt pr create --title "Automated PR" --source feature/my-branch

Minimal headless example (Bitbucket Cloud):

bash
export BKT_HOST=https://bitbucket.org
export BKT_TOKEN=my-api-token
export BKT_USERNAME=me@example.com
export BKT_WORKSPACE=my-workspace
export BKT_REPO=my-repo

bkt pr list

From Source

bash
git clone https://github.com/avivsinai/bitbucket-cli.git
cd bitbucket-cli
make build   # produces ./bin/bkt
./bin/bkt --help

Claude Code / Codex Skill

Install the bkt skill to give Claude Code or Codex CLI native Bitbucket knowledge:

<details open>
<summary><b>Via skills (Recommended)</b></summary>

Using Vercel's skills CLI:

bash
npx skills add avivsinai/bitbucket-cli -g -y

</details>

<details>
<summary><b>Via skild registry</b></summary>

bash
npx skild install @avivsinai/bkt -t claude -y

</details>

<details>
<summary><b>Via Skills Marketplace</b></summary>

var(--color-accent)]/40 pl-3 my-2 text-[var(--text-tertiary)]">Known Issue: Claude Code uses SSH to clone marketplace repos, which fails without SSH keys configured. See [issue #14485. Use the skills or skild methods instead.

bash
/plugin marketplace add avivsinai/skills-marketplace
/plugin install bkt@avivsinai-marketplace

</details>

<details>
<summary><b>Manual install</b></summary>

bash
git clone https://github.com/avivsinai/bitbucket-cli.git
cp -r bitbucket-cli/.claude/skills/bkt ~/.claude/skills/

</details>

Reviews