@pilatos/bitbucket-cli 1.13.2 → 1.15.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +51 -8
- package/dist/index.js +3909 -206
- package/package.json +3 -1
package/README.md
CHANGED
|
@@ -47,15 +47,28 @@
|
|
|
47
47
|
|
|
48
48
|
## Install
|
|
49
49
|
|
|
50
|
-
|
|
51
|
-
npm install -g @pilatos/bitbucket-cli
|
|
52
|
-
```
|
|
50
|
+
> **Requires:** [Bun](https://bun.sh) runtime 1.0 or higher. The CLI is installed via npm but runs on the Bun runtime — Node.js is not supported.
|
|
53
51
|
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
```
|
|
52
|
+
1. **Install Bun** (if `bun --version` fails):
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
curl -fsSL https://bun.sh/install | bash
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
2. **Install the CLI:**
|
|
57
59
|
|
|
58
|
-
|
|
60
|
+
```bash
|
|
61
|
+
npm install -g @pilatos/bitbucket-cli
|
|
62
|
+
bb --version
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
3. **Tab completion** (optional, recommended):
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
bb completion install
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
Then restart your shell.
|
|
59
72
|
|
|
60
73
|
---
|
|
61
74
|
|
|
@@ -78,7 +91,21 @@ bb pr approve 42
|
|
|
78
91
|
bb config set defaultWorkspace myworkspace
|
|
79
92
|
```
|
|
80
93
|
|
|
81
|
-
**Global options:** `--json`, `--no-color`, `-w, --workspace`, `-r, --repo`
|
|
94
|
+
**Global options:** `--json [fields]`, `--jq <expression>`, `--no-color`, `-w, --workspace`, `-r, --repo`
|
|
95
|
+
|
|
96
|
+
### Scripting with `--json` and `--jq`
|
|
97
|
+
|
|
98
|
+
`--json` accepts an optional comma-separated field list to project the output, and `--jq` filters the JSON in-process (no external `jq` binary required):
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
# Project to specific fields
|
|
102
|
+
bb pr list --json id,title,state
|
|
103
|
+
|
|
104
|
+
# Filter through built-in jq
|
|
105
|
+
bb pr list --json --jq '.pullRequests[] | select(.state == "OPEN") | .title'
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
See [JSON Output](https://bitbucket-cli.paulvanderlei.com/reference/json-output/) and the [Scripting guide](https://bitbucket-cli.paulvanderlei.com/guides/scripting/) for more.
|
|
82
109
|
|
|
83
110
|
---
|
|
84
111
|
|
|
@@ -89,6 +116,8 @@ Full documentation: **[bitbucket-cli.paulvanderlei.com](https://bitbucket-cli.pa
|
|
|
89
116
|
- [Quick Start Guide](https://bitbucket-cli.paulvanderlei.com/getting-started/quickstart/)
|
|
90
117
|
- [Command Reference](https://bitbucket-cli.paulvanderlei.com/commands/auth/)
|
|
91
118
|
- [Guides](https://bitbucket-cli.paulvanderlei.com/guides/scripting/) (Scripting, CI/CD)
|
|
119
|
+
- AI assistant integration (Claude Code, Cursor, Windsurf): see [Guides > AI Agents](https://bitbucket-cli.paulvanderlei.com/guides/ai-agents/)
|
|
120
|
+
- [Changelog](https://bitbucket-cli.paulvanderlei.com/help/changelog/) — what's new in recent releases
|
|
92
121
|
- [Help](https://bitbucket-cli.paulvanderlei.com/help/troubleshooting/) (Troubleshooting, FAQ)
|
|
93
122
|
|
|
94
123
|
---
|
|
@@ -102,6 +131,20 @@ Full documentation: **[bitbucket-cli.paulvanderlei.com](https://bitbucket-cli.pa
|
|
|
102
131
|
|
|
103
132
|
---
|
|
104
133
|
|
|
134
|
+
## Environment Variables
|
|
135
|
+
|
|
136
|
+
| Variable | Description |
|
|
137
|
+
| -------------- | ---------------------------------------------------------- |
|
|
138
|
+
| `BB_USERNAME` | Bitbucket username (fallback for `bb auth login`) |
|
|
139
|
+
| `BB_API_TOKEN` | Bitbucket API token (fallback for `bb auth login`; for CI) |
|
|
140
|
+
| `DEBUG` | Enable HTTP debug logging when set to `true` |
|
|
141
|
+
| `NO_COLOR` | Disable color output when set |
|
|
142
|
+
| `FORCE_COLOR` | Force color output when set (and not `0`) |
|
|
143
|
+
|
|
144
|
+
Full reference: [Environment variables](https://bitbucket-cli.paulvanderlei.com/reference/environment-variables/).
|
|
145
|
+
|
|
146
|
+
---
|
|
147
|
+
|
|
105
148
|
## Contributing
|
|
106
149
|
|
|
107
150
|
Read the [Contributing Guide](CONTRIBUTING.md) to get started.
|