bbk-cli 1.1.1 → 1.2.0

package/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.1.1"
+  ".": "1.2.0"
 }

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [1.2.0](https://github.com/hesedcasa/bbk-cli/compare/bbk-cli-v1.1.3...bbk-cli-v1.2.0) (2026-01-29)
+
+
+### 🎉 Features
+
+* add interactive config setup command with pre-population ([#18](https://github.com/hesedcasa/bbk-cli/issues/18)) ([7e802ff](https://github.com/hesedcasa/bbk-cli/commit/7e802fffaee7b62fe2edadaa65e29ebc8e2b452a))
+
+## [1.1.3](https://github.com/hesedcasa/bbk-cli/compare/bbk-cli-v1.1.2...bbk-cli-v1.1.3) (2026-01-29)
+
+
+### ♻️ Chores
+
+* migrate config system from YAML to INI format ([#12](https://github.com/hesedcasa/bbk-cli/issues/12)) ([2276ddf](https://github.com/hesedcasa/bbk-cli/commit/2276ddf0414814345e52016916120858cb74178e))
+
+## [1.1.2](https://github.com/hesedcasa/bbk-cli/compare/bbk-cli-v1.1.1...bbk-cli-v1.1.2) (2026-01-27)
+
+
+### 🛠️ Fixes
+
+* fix get-user return error when pass in username ([#10](https://github.com/hesedcasa/bbk-cli/issues/10)) ([732359f](https://github.com/hesedcasa/bbk-cli/commit/732359fb65f3165bb2fd93febaca9594497a07e4))
+
 ## [1.1.1](https://github.com/hesedcasa/bbk-cli/compare/bbk-cli-v1.1.0...bbk-cli-v1.1.1) (2026-01-27)
 
 

package/README.md

@@ -8,8 +8,7 @@ A powerful command-line interface for Bitbucket interaction with support for rep
 
 - 💻 **Interactive REPL** for Bitbucket exploration and management
 - 🚀 **Headless mode** for one-off command execution and automation
-- 🔐 **Multi-profile support** for managing different Bitbucket accounts
-- 🏢 **Default workspace support** - omit workspace parameter when configured
+- 🏢 **Default workspace support** - set once in config, omit from commands
 - 📊 **Multiple output formats**: JSON or TOON
 - 📦 **Repository management**: list and view repository details
 - 🔀 **Pull request operations**: list, view, and create pull requests with auto-reviewers
@@ -34,129 +33,146 @@ npm install -g bbk-cli
 
 ## Configuration
 
-### Step 1: Create API Token
+### Recommended: Interactive Setup
+
+The easiest way to configure bbk-cli is using the interactive config command:
+
+```bash
+bbk-cli config
+```
+
+The interactive setup prompts for:
+
+1. **email** (required) - Your Bitbucket account email
+2. **api_token** (required) - Your Bitbucket API token
+3. **workspace** (optional) - Default workspace to use with commands
+4. **format** (optional) - Default output format (`json` or `toon`, defaults to `json`)
+
+### Creating an API Token
+
+Before running the config command, create an API token:
 
 1. Go to [Atlassian API Tokens](https://id.atlassian.com/manage-profile/security/api-tokens)
 2. Click "Create API token"
 3. Give it a label (e.g., "BBK CLI")
 4. Copy the generated token
 
-### Step 2: Create Configuration File
-
-Create a configuration file at `.claude/bitbucket-config.local.md` in your project root:
-
-```markdown
----
-profiles:
-  cloud:
-    email: your-email@example.com
-    apiToken: YOUR_API_TOKEN_HERE
-    defaultWorkspace: myworkspace # Optional: default workspace for commands
+### Manual Configuration (Alternative)
 
-defaultProfile: cloud
-defaultFormat: json
----
+You can also manually create the configuration file at `~/.bbkcli`:
 
-# Bitbucket API Configuration
+```ini
+[auth]
+email=your-email@example.com
+api_token=YOUR_API_TOKEN_HERE
 
-This file stores your Bitbucket API connection profiles.
+[defaults]
+workspace=myworkspace
+format=json
 ```
 
 ### Configuration Options
 
-- **profiles**: Named Bitbucket connection profiles
+- **[auth] section** - Required authentication credentials
   - `email`: Your Bitbucket email
-  - `apiToken`: Your Bitbucket API token
-  - `defaultWorkspace`: (Optional) Default workspace to use if not specified in commands
-
-- **defaultProfile**: Profile name to use when none specified
-- **defaultFormat**: Default output format (`json` or `toon`)
-
-### Multiple Profiles Example
-
-```yaml
----
-profiles:
-  personal:
-    email: john@email.com
-    apiToken: <api_token>
-    defaultWorkspace: personal-workspace
-
-  work:
-    email: john@company.com
-    apiToken: <api_token>
-    defaultWorkspace: company-workspace
-
-defaultProfile: personal
-defaultFormat: json
----
-```
+  - `api_token`: Your Bitbucket API token
+
+- **[defaults] section** - Optional default settings
+  - `workspace`: Default workspace to use if not specified in commands (recommended)
+  - `format`: Default output format (`json` or `toon`)
+
+**Tip:** Setting a default workspace in your config file allows you to omit the workspace parameter from all commands, making them much more concise. You can still specify a workspace parameter in any command if you need to work with a different workspace.
 
 ## Quick Start
 
+### First-Time Setup
+
+Before using bbk-cli, configure your credentials:
+
+```bash
+bbk-cli config
+```
+
+Follow the interactive prompts to enter your Bitbucket email and API token.
+
 ### Interactive Mode
 
 Start the CLI and interact with Bitbucket through a REPL:
 
 ```bash
-npx bbk-cli
+bbk-cli
 ```
 
 Once started, you'll see the `bbk>` prompt:
 
+**Tip:** Set a default workspace in your config file (see Configuration section) to omit the workspace parameter from all commands.
+
 ```
-bbk> list-repositories {"workspace":"myworkspace"}
-bbk> list-repositories {}              # Uses profile's defaultWorkspace
-bbk> get-repository {"workspace":"myworkspace","repoSlug":"my-repo"}
-bbk> get-repository {"repoSlug":"my-repo"}  # Uses profile's defaultWorkspace
-bbk> list-pullrequests {"workspace":"myworkspace","repoSlug":"my-repo","state":"OPEN"}
-bbk> list-pullrequests {"repoSlug":"my-repo","state":"OPEN"}  # Uses defaultWorkspace
+bbk> list-repositories
+bbk> get-repository {"repoSlug":"my-repo"}
+bbk> list-pullrequests {"repoSlug":"my-repo","state":"OPEN"}
+```
+
+**Note:** You can optionally specify a workspace parameter if you need to work with a different workspace:
+
+```
+bbk> list-repositories {"workspace":"other-workspace"}
 ```
 
 ### Headless Mode
 
-Execute single commands directly:
+Execute single commands directly. (Note: Run `bbk-cli config` first to set up credentials):
+
+**Tip:** Set a default workspace in your config file to omit the workspace parameter from commands.
 
 ```bash
 # Test connection
-npx bbk-cli test-connection
+bbk-cli test-connection
 
 # List all repositories
-npx bbk-cli list-repositories '{"workspace":"myworkspace"}'
+bbk-cli list-repositories
 
 # Get repository details
-npx bbk-cli get-repository '{"workspace":"myworkspace","repoSlug":"my-repo"}'
+bbk-cli get-repository '{"repoSlug":"my-repo"}'
 
 # List pull requests
-npx bbk-cli list-pullrequests '{"workspace":"myworkspace","repoSlug":"my-repo","state":"OPEN"}'
+bbk-cli list-pullrequests '{"repoSlug":"my-repo","state":"OPEN"}'
 
 # Get pull request details
-npx bbk-cli get-pullrequest '{"workspace":"myworkspace","repoSlug":"my-repo","pullRequestId":123}'
+bbk-cli get-pullrequest '{"repoSlug":"my-repo","pullRequestId":123}'
 
 # Create a new pull request
-npx bbk-cli create-pullrequest '{"workspace":"myworkspace","repoSlug":"my-repo","title":"Feature PR","sourceBranch":"feature/new","destinationBranch":"main"}'
+bbk-cli create-pullrequest '{"repoSlug":"my-repo","title":"Feature PR","sourceBranch":"feature/new","destinationBranch":"main"}'
 
 # List issues
-npx bbk-cli list-issues '{"workspace":"myworkspace","repoSlug":"my-repo"}'
+bbk-cli list-issues '{"repoSlug":"my-repo"}'
 
 # Create an issue
-npx bbk-cli create-issue '{"workspace":"myworkspace","repoSlug":"my-repo","title":"Bug found","kind":"bug"}'
+bbk-cli create-issue '{"repoSlug":"my-repo","title":"Bug found","kind":"bug"}'
+```
+
+**Note:** You can optionally specify a workspace parameter if working with multiple workspaces:
+
+```bash
+bbk-cli list-repositories '{"workspace":"other-workspace"}'
 ```
 
 ## Available Commands
 
+**Note:** All commands support an optional `workspace` parameter if you need to work with a different workspace than your default.
+
 ### Repository Commands
 
 - **list-repositories** - List all repositories in a workspace
 
   ```bash
-  bbk> list-repositories {"workspace":"myworkspace"}
-  bbk> list-repositories {"workspace":"myworkspace","format":"json"}
+  bbk> list-repositories
+  bbk> list-repositories {"format":"json"}
   ```
 
 - **get-repository** - Get details of a specific repository
   ```bash
-  bbk> get-repository {"workspace":"myworkspace","repoSlug":"my-repo"}
+  bbk> get-repository {"repoSlug":"my-repo"}
   ```
 
 ### Pull Request Commands
@@ -164,21 +180,21 @@ npx bbk-cli create-issue '{"workspace":"myworkspace","repoSlug":"my-repo","title
 - **list-pullrequests** - List pull requests in a repository
 
   ```bash
-  bbk> list-pullrequests {"workspace":"myworkspace","repoSlug":"my-repo"}
-  bbk> list-pullrequests {"workspace":"myworkspace","repoSlug":"my-repo","state":"OPEN"}
+  bbk> list-pullrequests {"repoSlug":"my-repo"}
+  bbk> list-pullrequests {"repoSlug":"my-repo","state":"OPEN"}
   ```
 
 - **get-pullrequest** - Get details of a specific pull request
 
   ```bash
-  bbk> get-pullrequest {"workspace":"myworkspace","repoSlug":"my-repo","pullRequestId":123}
+  bbk> get-pullrequest {"repoSlug":"my-repo","pullRequestId":123}
   ```
 
 - **create-pullrequest** - Create a new pull request
 
   ```bash
-  bbk> create-pullrequest {"workspace":"myworkspace","repoSlug":"my-repo","title":"Feature PR","sourceBranch":"feature/new","destinationBranch":"main"}
-  bbk> create-pullrequest {"workspace":"myworkspace","repoSlug":"my-repo","title":"Feature PR","sourceBranch":"feature/new","destinationBranch":"main","description":"PR description"}
+  bbk> create-pullrequest {"repoSlug":"my-repo","title":"Feature PR","sourceBranch":"feature/new","destinationBranch":"main"}
+  bbk> create-pullrequest {"repoSlug":"my-repo","title":"Feature PR","sourceBranch":"feature/new","destinationBranch":"main","description":"PR description"}
   ```
 
   **Note**: This command automatically adds the repository's default reviewers (excluding the PR author) to the pull request.
@@ -188,7 +204,7 @@ npx bbk-cli create-issue '{"workspace":"myworkspace","repoSlug":"my-repo","title
 - **list-branches** - List branches in a repository
 
   ```bash
-  bbk> list-branches {"workspace":"myworkspace","repoSlug":"my-repo"}
+  bbk> list-branches {"repoSlug":"my-repo"}
   ```
 
 ### Commit Commands
@@ -196,8 +212,8 @@ npx bbk-cli create-issue '{"workspace":"myworkspace","repoSlug":"my-repo","title
 - **list-commits** - List commits in a repository
 
   ```bash
-  bbk> list-commits {"workspace":"myworkspace","repoSlug":"my-repo"}
-  bbk> list-commits {"workspace":"myworkspace","repoSlug":"my-repo","branch":"main"}
+  bbk> list-commits {"repoSlug":"my-repo"}
+  bbk> list-commits {"repoSlug":"my-repo","branch":"main"}
   ```
 
 ### Issue Commands
@@ -205,20 +221,20 @@ npx bbk-cli create-issue '{"workspace":"myworkspace","repoSlug":"my-repo","title
 - **list-issues** - List issues in a repository
 
   ```bash
-  bbk> list-issues {"workspace":"myworkspace","repoSlug":"my-repo"}
+  bbk> list-issues {"repoSlug":"my-repo"}
   ```
 
 - **get-issue** - Get details of a specific issue
 
   ```bash
-  bbk> get-issue {"workspace":"myworkspace","repoSlug":"my-repo","issueId":123}
+  bbk> get-issue {"repoSlug":"my-repo","issueId":123}
   ```
 
 - **create-issue** - Create a new issue
 
   ```bash
-  bbk> create-issue {"workspace":"myworkspace","repoSlug":"my-repo","title":"Bug found"}
-  bbk> create-issue {"workspace":"myworkspace","repoSlug":"my-repo","title":"Bug found","content":"Description here","kind":"bug","priority":"major"}
+  bbk> create-issue {"repoSlug":"my-repo","title":"Bug found"}
+  bbk> create-issue {"repoSlug":"my-repo","title":"Bug found","content":"Description here","kind":"bug","priority":"major"}
   ```
 
 ### Pipeline Commands
@@ -226,15 +242,15 @@ npx bbk-cli create-issue '{"workspace":"myworkspace","repoSlug":"my-repo","title
 - **list-pipelines** - List pipelines in a repository
 
   ```bash
-  bbk> list-pipelines {"workspace":"myworkspace","repoSlug":"my-repo"}
+  bbk> list-pipelines {"repoSlug":"my-repo"}
   ```
 
 ### User Commands
 
 - **get-user** - Get user information
   ```bash
-  bbk> get-user
-  bbk> get-user {"username":"myusername"}
+  bbk> get-user  # Get current authenticated user
+  bbk> get-user {"userId":"04b587de-b844-4c54-b4ec-1e33157fcc15"}  # Get specific user by UUID
   ```
 
 ### Utility Commands
@@ -250,8 +266,6 @@ Special commands available in the REPL:
 
 - **commands** - List all available commands
 - **help** or **?** - Show help message
-- **profile \<name\>** - Switch to a different profile
-- **profiles** - List all available profiles
 - **format \<type\>** - Set output format (json, toon)
 - **clear** - Clear the screen
 - **exit**, **quit**, or **q** - Exit the CLI
@@ -264,7 +278,11 @@ Machine-readable JSON format (default):
 
 ```bash
 bbk> format json
-bbk> list-repositories {"workspace":"myworkspace"}
+bbk> list-repositories
+```
+
+```bash
+bbk-cli list-repositories '{"format":"json"}'
 ```
 
 ### TOON Format
@@ -273,18 +291,21 @@ bbk> list-repositories {"workspace":"myworkspace"}
 
 ```bash
 bbk> format toon
-bbk> list-pullrequests {"workspace":"myworkspace","repoSlug":"my-repo"}
+bbk> list-pullrequests {"repoSlug":"my-repo"}
+```
+
+```bash
+bbk-cli list-repositories '{"format":"toon"}'
 ```
 
 ## Security
 
 ⚠️ **Important Security Notes:**
 
-1. **Never commit** `.claude/bitbucket-config.local.md` to version control
-2. Add `*.local.md` to your `.gitignore`
+1. **Never commit** `~/.bbkcli` to version control
+2. The config file is created with secure permissions
 3. Keep your API tokens secure and rotate them periodically
-4. Use different credentials for different environments
-5. API tokens have the same permissions as your user account
+4. API tokens have the same permissions as your user account
 
 ## Development
 
@@ -321,49 +342,13 @@ npm run find-deadcode       # Find unused exports
 npm run pre-commit          # Run format + find-deadcode
 ```
 
-## Examples
-
-### Basic Workflow
-
-```bash
-# Start interactive mode
-npx bbk-cli
-
-# List all repositories in workspace
-bbk> list-repositories {"workspace":"myworkspace"}
-
-# Get specific repository
-bbk> get-repository {"workspace":"myworkspace","repoSlug":"my-repo"}
-
-# List pull requests
-bbk> list-pullrequests {"workspace":"myworkspace","repoSlug":"my-repo","state":"OPEN"}
-
-# Get specific pull request
-bbk> get-pullrequest {"workspace":"myworkspace","repoSlug":"my-repo","pullRequestId":123}
-
-# Create new pull request
-bbk> create-pullrequest {"workspace":"myworkspace","repoSlug":"my-repo","title":"Feature PR","sourceBranch":"feature/new","destinationBranch":"main"}
-
-# List branches
-bbk> list-branches {"workspace":"myworkspace","repoSlug":"my-repo"}
-
-# List commits
-bbk> list-commits {"workspace":"myworkspace","repoSlug":"my-repo","branch":"main"}
-
-# List issues
-bbk> list-issues {"workspace":"myworkspace","repoSlug":"my-repo"}
-
-# Create issue
-bbk> create-issue {"workspace":"myworkspace","repoSlug":"my-repo","title":"Bug found","kind":"bug"}
-```
-
 ## Troubleshooting
 
 ### Connection Issues
 
 ```bash
 # Test your connection
-npx bbk-cli test-connection
+bbk-cli test-connection
 
 # Common issues:
 # 1. Invalid API token - regenerate credentials
@@ -377,7 +362,7 @@ npx bbk-cli test-connection
 
 ### Permission Errors
 
-- API token inherit your user permissions
+- API token inherits your user permissions
 - Check that your Bitbucket account has access to the workspace/repository
 - Some operations require specific repository permissions
 - Pull request creation requires write access to the repository

package/dist/cli/wrapper.d.ts

@@ -4,7 +4,6 @@
 export declare class wrapper {
     private rl;
     private config;
-    private currentProfile;
     private currentFormat;
     constructor();
     /**

package/dist/cli/wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../../src/cli/wrapper.ts"],"names":[],"mappings":"AAuBA;;GAEG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAAqB;IAC/B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,aAAa,CAA2B;;IAUhD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB9B;;;OAGG;YACW,aAAa;IAmF3B;;;;OAIG;YACW,UAAU;IA8JxB;;OAEG;IACH,OAAO,CAAC,SAAS;IAuCjB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B5B;;OAEG;YACW,UAAU;CAKzB"}
+{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../../src/cli/wrapper.ts"],"names":[],"mappings":"AAuBA;;GAEG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAAqB;IAC/B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,aAAa,CAA2B;;IAUhD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAa9B;;;OAGG;YACW,aAAa;IA0D3B;;;;OAIG;YACW,UAAU;IA2JxB;;OAEG;IACH,OAAO,CAAC,SAAS;IAmCjB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B5B;;OAEG;YACW,UAAU;CAKzB"}