bob-dev 0.1.0__tar.gz → 0.2.1__tar.gz

{bob_dev-0.1.0/src/bob_dev.egg-info → bob_dev-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bob-dev
-Version: 0.1.0
+Version: 0.2.1
 Summary: An AI developer to write code for you
 Author-email: Samuel Pereira dos Santos <samuelsantosdev@gmail.com>
 Requires-Python: >=3.14
@@ -17,21 +17,22 @@ Dynamic: license-file
 
 ![BOB-Dev Banner](https://github.com/samuelsantosdev/bob-dev/blob/main/assets/banner.png)
 
-Given a Jira task ID it will:
+Given a task ID (Jira or GitLab) it will:
 
-1. **Fetch** the task title, description, and fix versions from Jira.
+1. **Fetch** the task title, description, and fix versions from Jira or GitLab.
 2. **Read** your project's Markdown documentation to build rich LLM context.
 3. **Generate** a precise Claude Code prompt (via GROK or OpenAI), including project-framework context, implementation steps, and test scenarios.
 4. **Analyse** the prompt for ambiguities and security concerns.
-5. **Execute** the prompt with the Claude Code CLI (optional – you can review first).
+5. **Select** (optionally) a Claude Code agent to run the implementation.
+6. **Execute** the prompt with the Claude Code CLI (optional – you can review first).
 
 ---
 
 ## Requirements
 
-- Python 3.11+
+- Python 3.14+
 - [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and available on `$PATH` as `claude`
-- A Jira Cloud account with an [API token](https://id.atlassian.com/manage-profile/security/api-tokens)
+- A **Jira Cloud** account with an [API token](https://id.atlassian.com/manage-profile/security/api-tokens) **or** a **GitLab** account with a [personal access token](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)
 - An [xAI / GROK](https://console.x.ai/) **or** [OpenAI](https://platform.openai.com/) API key
 
 ---
@@ -52,19 +53,37 @@ Run the interactive setup wizard the first time:
 bob-dev --configure
 ```
 
-This will prompt for your API keys, Jira credentials, and Claude Code API key.
+This will prompt for your LLM API key, task manager (Jira or GitLab) credentials, and Claude Code API key.
+
+### Environment variables
+
+| Variable | Description |
+|----------|-------------|
+| `AGENT` | LLM backend: `GROK` (default) or `OPENAI` |
+| `GROK_API_KEY` | xAI / GROK secret key |
+| `OPENAI_API_KEY` | OpenAI secret key |
+| `TASK_MANAGER` | Task manager: `JIRA` (default) or `GITLAB` |
+| `JIRA_URL` | e.g. `https://your-org.atlassian.net` |
+| `JIRA_EMAIL` | Atlassian account e-mail |
+| `JIRA_API_TOKEN` | Atlassian API token |
+| `GITLAB_URL` | e.g. `https://gitlab.com` |
+| `GITLAB_API_TOKEN` | GitLab personal access token |
 
 ---
 
 ## Usage
 
 ```bash
+# Jira
 bob-dev --task_id PROJ-123 --path /path/to/your/repo
+
+# GitLab (issue IID)
+bob-dev --task_id 42 --path /path/to/your/repo
 ```
 
 | Flag | Description |
 |------|-------------|
-| `--task_id` | Jira task ID to process (required for normal workflow) |
+| `--task_id` | Task ID to process — Jira key (`PROJ-123`) or GitLab issue IID (`42`) |
 | `--path` | Path to the target repository (default: current directory) |
 | `--agent` | LLM backend: `GROK` or `OPENAI` (default: value of `AGENT` in `.env`) |
 | `--configure` | Run the interactive configuration wizard |
@@ -76,12 +95,14 @@ bob-dev --task_id PROJ-123 --path /path/to/your/repo
 ```
 src/bob_dev/
 ├── cli.py                  # Entry point & main workflow orchestration
-├── helpers/
+├── services/
 │   ├── terminal.py         # ANSI colours, print helpers, spinner animation
-│   ├── jira_helper.py      # Jira API connection + ADF-to-text parsing
-│   ├── llm_helper.py       # LLM client, model selection, prompt generation
-│   ├── project_helper.py   # Markdown context collection + framework detection
-│   └── config_helper.py    # .env management + credential validation
+│   ├── jira.py             # Jira API connection + ADF-to-text parsing
+│   ├── gitlab.py           # GitLab API connection via python-gitlab
+│   ├── claude.py           # Claude Code CLI utilities (agent listing)
+│   ├── llm.py              # LLM client, model selection, prompt generation
+│   ├── project.py          # Markdown context collection + framework detection
+│   └── config.py           # .env management + credential validation
 └── constants/
     └── frameworks.py       # Known framework names used for auto-detection
 ```

{bob_dev-0.1.0 → bob_dev-0.2.1}/README.md

@@ -4,21 +4,22 @@
 
 ![BOB-Dev Banner](https://github.com/samuelsantosdev/bob-dev/blob/main/assets/banner.png)
 
-Given a Jira task ID it will:
+Given a task ID (Jira or GitLab) it will:
 
-1. **Fetch** the task title, description, and fix versions from Jira.
+1. **Fetch** the task title, description, and fix versions from Jira or GitLab.
 2. **Read** your project's Markdown documentation to build rich LLM context.
 3. **Generate** a precise Claude Code prompt (via GROK or OpenAI), including project-framework context, implementation steps, and test scenarios.
 4. **Analyse** the prompt for ambiguities and security concerns.
-5. **Execute** the prompt with the Claude Code CLI (optional – you can review first).
+5. **Select** (optionally) a Claude Code agent to run the implementation.
+6. **Execute** the prompt with the Claude Code CLI (optional – you can review first).
 
 ---
 
 ## Requirements
 
-- Python 3.11+
+- Python 3.14+
 - [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and available on `$PATH` as `claude`
-- A Jira Cloud account with an [API token](https://id.atlassian.com/manage-profile/security/api-tokens)
+- A **Jira Cloud** account with an [API token](https://id.atlassian.com/manage-profile/security/api-tokens) **or** a **GitLab** account with a [personal access token](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)
 - An [xAI / GROK](https://console.x.ai/) **or** [OpenAI](https://platform.openai.com/) API key
 
 ---
@@ -39,19 +40,37 @@ Run the interactive setup wizard the first time:
 bob-dev --configure
 ```
 
-This will prompt for your API keys, Jira credentials, and Claude Code API key.
+This will prompt for your LLM API key, task manager (Jira or GitLab) credentials, and Claude Code API key.
+
+### Environment variables
+
+| Variable | Description |
+|----------|-------------|
+| `AGENT` | LLM backend: `GROK` (default) or `OPENAI` |
+| `GROK_API_KEY` | xAI / GROK secret key |
+| `OPENAI_API_KEY` | OpenAI secret key |
+| `TASK_MANAGER` | Task manager: `JIRA` (default) or `GITLAB` |
+| `JIRA_URL` | e.g. `https://your-org.atlassian.net` |
+| `JIRA_EMAIL` | Atlassian account e-mail |
+| `JIRA_API_TOKEN` | Atlassian API token |
+| `GITLAB_URL` | e.g. `https://gitlab.com` |
+| `GITLAB_API_TOKEN` | GitLab personal access token |
 
 ---
 
 ## Usage
 
 ```bash
+# Jira
 bob-dev --task_id PROJ-123 --path /path/to/your/repo
+
+# GitLab (issue IID)
+bob-dev --task_id 42 --path /path/to/your/repo
 ```
 
 | Flag | Description |
 |------|-------------|
-| `--task_id` | Jira task ID to process (required for normal workflow) |
+| `--task_id` | Task ID to process — Jira key (`PROJ-123`) or GitLab issue IID (`42`) |
 | `--path` | Path to the target repository (default: current directory) |
 | `--agent` | LLM backend: `GROK` or `OPENAI` (default: value of `AGENT` in `.env`) |
 | `--configure` | Run the interactive configuration wizard |
@@ -63,12 +82,14 @@ bob-dev --task_id PROJ-123 --path /path/to/your/repo
 ```
 src/bob_dev/
 ├── cli.py                  # Entry point & main workflow orchestration
-├── helpers/
+├── services/
 │   ├── terminal.py         # ANSI colours, print helpers, spinner animation
-│   ├── jira_helper.py      # Jira API connection + ADF-to-text parsing
-│   ├── llm_helper.py       # LLM client, model selection, prompt generation
-│   ├── project_helper.py   # Markdown context collection + framework detection
-│   └── config_helper.py    # .env management + credential validation
+│   ├── jira.py             # Jira API connection + ADF-to-text parsing
+│   ├── gitlab.py           # GitLab API connection via python-gitlab
+│   ├── claude.py           # Claude Code CLI utilities (agent listing)
+│   ├── llm.py              # LLM client, model selection, prompt generation
+│   ├── project.py          # Markdown context collection + framework detection
+│   └── config.py           # .env management + credential validation
 └── constants/
     └── frameworks.py       # Known framework names used for auto-detection
 ```

{bob_dev-0.1.0 → bob_dev-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bob-dev"
-version = "0.1.0"
+version = "0.2.1"
 description = "An AI developer to write code for you"
 readme = "README.md"
 authors = [{ name="Samuel Pereira dos Santos", email="samuelsantosdev@gmail.com" }]

{bob_dev-0.1.0 → bob_dev-0.2.1}/src/bob_dev/cli.py

@@ -23,6 +23,7 @@ Environment variables (.env next to this file or exported):
     JIRA_URL        – https://your-org.atlassian.net
     JIRA_EMAIL      – Atlassian account e-mail
     JIRA_API_TOKEN  – Atlassian API token
+    TASK_MANAGER    – "JIRA" (default) or "GITLAB"
 """
 
 from __future__ import annotations
@@ -36,7 +37,7 @@ from pathlib import Path
 from InquirerPy import inquirer
 from dotenv import load_dotenv
 
-from .helpers.terminal import (
+from .services.terminal import (
     BOLD,
     RESET,
     print_error,
@@ -47,10 +48,12 @@ from .helpers.terminal import (
     run_subprocess,
     run_with_spinner,
 )
-from .helpers.jira_helper import get_jira_task
-from .helpers.llm_helper import analyse_prompt, llm_model, prompt_claude_code
-from .helpers.project_helper import build_md_context, identify_framework
-from .helpers.config_helper import check_configuration, update_env_file
+from .services.jira import get_jira_task
+from .services.gitlab import get_gitlab_task
+from .services.claude import read_agents_from_claude
+from .services.llm import analyse_prompt, llm_model, prompt_claude_code
+from .services.project import build_md_context, identify_framework
+from .services.config import check_configuration, update_env_file
 
 # ---------------------------------------------------------------------------
 # Module-level configuration
@@ -58,15 +61,20 @@ from .helpers.config_helper import check_configuration, update_env_file
 
 SCRIPT_DIR = Path(__file__).resolve().parent
 load_dotenv(SCRIPT_DIR / ".env")
+ENV_PATH = Path.home() / ".bob_dev" / ".env"
 
 OPENAI_API_KEY = os.environ.get("OPENAI_API_KEY", "")
 GROK_API_KEY   = os.environ.get("GROK_API_KEY", "")
 AGENT          = os.environ.get("AGENT", "GROK").upper()   # "GROK" or "OPENAI"
+TASK_MANAGER   = os.environ.get("TASK_MANAGER", "JIRA").upper()  # "JIRA" or "GITLAB"
 
 JIRA_URL       = os.environ.get("JIRA_URL", "")
 JIRA_EMAIL     = os.environ.get("JIRA_EMAIL", "")
 JIRA_API_TOKEN = os.environ.get("JIRA_API_TOKEN", "")
 
+GITLAB_URL       = os.environ.get("GITLAB_URL", "")
+GITLAB_API_TOKEN = os.environ.get("GITLAB_API_TOKEN", "")
+
 REPO_BASE_PATH  = Path("./")   # Overridden by --path at runtime.
 CLAUDE_CODE_CMD = "claude"     # Must be on $PATH.
 
@@ -84,7 +92,7 @@ def main() -> None:
     )
     parser.add_argument(
         "--task_id", type=str,
-        help="Jira task ID to process (e.g. PROJ-123).",
+        help="Task ID to process (e.g. PROJ-123 for Jira or 42 for GitLab).",
     )
     parser.add_argument(
         "--path", type=str, default="./",
@@ -107,17 +115,21 @@ def main() -> None:
 
     # ── Require task_id for normal workflow ──────────────────────────────────
     if not args.task_id:
-        print_error("Jira task ID is required. Use --task_id PROJ-123.")
+        print_error("Task ID is required. Use --task_id PROJ-123 for Jira or 42 for GitLab.")
         sys.exit(1)
 
     task_id = args.task_id.strip().upper()
     agent   = args.agent.upper()
 
     # ── Validate credentials before making any API calls ────────────────────
-    if not all([JIRA_URL, JIRA_EMAIL, JIRA_API_TOKEN]):
+    if TASK_MANAGER == "JIRA" and not all([JIRA_URL, JIRA_EMAIL, JIRA_API_TOKEN]):
         print_error("Jira credentials are not configured. Run `bob-dev --configure`.")
         sys.exit(1)
 
+    if TASK_MANAGER == "GITLAB" and not all([GITLAB_URL, GITLAB_API_TOKEN]):
+        print_error("GitLab credentials are not configured. Run `bob-dev --configure`.")
+        sys.exit(1)
+
     if agent == "GROK" and not GROK_API_KEY:
         print_error("GROK_API_KEY is not set. Run `bob-dev --configure`.")
         sys.exit(1)
@@ -135,18 +147,26 @@ def main() -> None:
         sys.exit(1)
 
     print_info(f"Project path  : {REPO_BASE_PATH}")
-    print_info(f"Jira task ID  : {task_id}")
+    print_info(f"{TASK_MANAGER} task ID  : {task_id}")
     print_info(f"LLM backend   : {agent} ({llm_model(agent)})")
     print()
 
-    # ── Step 1 – Fetch Jira task ─────────────────────────────────────────────
-    print_step("[1/4]", f"Fetching Jira task {task_id} …")
+    # ── Step 1 – Fetch task ─────────────────────────────────────────────
+    print_step("[1/4]", f"Fetching {TASK_MANAGER} task {task_id} …")
 
-    task = asyncio.run(run_with_spinner(
-        get_jira_task,
-        task_id, JIRA_URL, JIRA_EMAIL, JIRA_API_TOKEN,
-        label="Fetching Jira task",
-    ))
+    if TASK_MANAGER == "JIRA":
+        task = asyncio.run(run_with_spinner(
+            get_jira_task,
+            task_id, JIRA_URL, JIRA_EMAIL, JIRA_API_TOKEN,
+            label="Fetching Jira task",
+        ))
+
+    if TASK_MANAGER == "GITLAB":
+        task = asyncio.run(run_with_spinner(
+            get_gitlab_task,
+            task_id, GITLAB_URL, GITLAB_API_TOKEN,
+            label="Fetching GitLab task",
+        ))
 
     print_success(f"Title         : {task['title']}")
     print_success(f"Fix versions  : {', '.join(task['fix_versions']) or 'N/A'}")
@@ -154,9 +174,10 @@ def main() -> None:
 
     acceptance_criteria = task["description"]
     if not acceptance_criteria.strip():
-        print_error("The Jira task has no description / acceptance criteria.")
+        print_error(f"The {TASK_MANAGER} task has no description / acceptance criteria.")
         sys.exit(1)
 
+
     # ── Step 2 – Read project docs & generate prompt ─────────────────────────
     print_step("[2/4]", f"Generating Claude Code prompt via {agent} ({llm_model(agent)}) …")
 
@@ -211,17 +232,35 @@ def main() -> None:
         print_info(f"Aborted. Prompt saved to {prompt_file}")
         sys.exit(0)
 
+    print_info("Prompt preview:")
+    print("-" * 68)
+    print(prompt_md)
+    print("-" * 68)
+    answer = input("\nAre you sure? This will run the Claude Code CLI with the generated prompt. [y/N] ").strip().lower()
+    if answer != "y":
+        print_info("Aborted by user.")
+        sys.exit(0)
+    
+    answer = input("Do you want select a agent to do this development? [y/N] ").strip().upper()
+    agent_claude = ""
+    if answer == "Y":
+        agents_of_claude = read_agents_from_claude(CLAUDE_CODE_CMD)
+        agent_claude = inquirer.select(
+            message="Select the agent to do the development:",
+            choices=agents_of_claude,
+        ).execute()
+
     # ── Step 4 – Pass prompt to Claude Code ──────────────────────────────────
     print_step("[4/4]", "Passing prompt to Claude Code …")
     print()
-    asyncio.run(_pass_to_claude_code(prompt_md, task_id))
+    asyncio.run(_pass_to_claude_code(prompt_md, task_id, agent_claude))
 
 
 # ---------------------------------------------------------------------------
 # Internal helpers
 # ---------------------------------------------------------------------------
 
-async def _pass_to_claude_code(prompt_md: str, task_id: str) -> None:
+async def _pass_to_claude_code(prompt_md: str, task_id: str, agent_claude: str=None) -> None:
     """Write the prompt to a temp file, then run Claude Code non-interactively."""
 
     # Persist the prompt so the user can review it regardless of outcome.
@@ -231,6 +270,8 @@ async def _pass_to_claude_code(prompt_md: str, task_id: str) -> None:
     print_info(f"Prompt saved to: {prompt_file}")
 
     cmd = [CLAUDE_CODE_CMD, "--dangerously-skip-permissions", "--print", prompt_md]
+    if agent_claude:
+        cmd.extend(["--agent", agent_claude])
     print_info(f"Running: {' '.join(cmd[:2])} <prompt>")
     print()
 
@@ -242,7 +283,9 @@ async def _pass_to_claude_code(prompt_md: str, task_id: str) -> None:
 
 def _run_configure() -> None:
     """Interactive wizard to write API keys and Jira credentials to .env."""
-    env_path = SCRIPT_DIR / ".env"
+    env_path = ENV_PATH
+    env_path.parent.mkdir(parents=True, exist_ok=True)
+    print(f"Configuration file will be saved to: {env_path}")
     print_step("[CONFIGURE]", "Running initial configuration …")
 
     # Choose the LLM backend.
@@ -258,20 +301,40 @@ def _run_configure() -> None:
     update_env_file(env_key, api_key, env_path)
     print_success(f"{system_choice} API key saved.")
 
-    # Jira credentials.
-    print("\nJira configuration:")
-    jira_url   = input("JIRA_URL   (e.g. https://your-org.atlassian.net): ").strip()
-    jira_email = input("JIRA_EMAIL (your Atlassian account e-mail)       : ").strip()
-    jira_token = input("JIRA_API_TOKEN (Atlassian API token)              : ").strip()
-
-    for key, val in [
-        ("JIRA_URL",       jira_url),
-        ("JIRA_EMAIL",     jira_email),
-        ("JIRA_API_TOKEN", jira_token),
-    ]:
-        update_env_file(key, val, env_path)
-
-    print_success("Jira configuration saved.")
+    print("\n Tasks manager configuration:")
+    task_manager = inquirer.select(
+        message="Select the default task manager:",
+        choices=["JIRA", "GITLAB"],
+    ).execute()
+    update_env_file("TASK_MANAGER", task_manager, env_path)
+    print_success(f"Task manager set to {task_manager}.")
+    
+    print("\nNote: The rest of the configuration depends on the selected task manager. You can run `bob-dev --configure` again to set it up later.")
+
+    if task_manager == "JIRA":
+        # Jira credentials.
+        print("\nJira configuration:")
+        jira_url   = input("JIRA_URL   (e.g. https://your-org.atlassian.net): ").strip()
+        jira_email = input("JIRA_EMAIL (your Atlassian account e-mail)       : ").strip()
+        jira_token = input("JIRA_API_TOKEN (Atlassian API token)              : ").strip()
+        for key, val in [
+            ("JIRA_URL",       jira_url),
+            ("JIRA_EMAIL",     jira_email),
+            ("JIRA_API_TOKEN", jira_token),
+        ]:
+            update_env_file(key, val, env_path)
+    if task_manager == "GITLAB":
+        # GitLab credentials.
+        print("\nGitLab configuration:")
+        gitlab_url   = input("GITLAB_URL   (e.g. https://gitlab.com)            : ").strip()
+        gitlab_token = input("GITLAB_API_TOKEN (GitLab API token)              : ").strip()
+        for key, val in [
+            ("GITLAB_URL",     gitlab_url),
+            ("GITLAB_API_TOKEN", gitlab_token),
+        ]:
+            update_env_file(key, val, env_path)
+
+    print_success(f"{task_manager} configuration saved.")
 
     # Claude Code API key.
     print("\nClaude Code API key:")
@@ -286,6 +349,9 @@ def _run_configure() -> None:
             agent          = os.environ.get("AGENT", "GROK").upper(),
             grok_api_key   = os.environ.get("GROK_API_KEY", ""),
             openai_api_key = os.environ.get("OPENAI_API_KEY", ""),
+            gitlab_url     = os.environ.get("GITLAB_URL", ""),
+            gitlab_api_token = os.environ.get("GITLAB_API_TOKEN", ""),
+            task_manager   = os.environ.get("TASK_MANAGER", "JIRA").upper(),
             jira_url       = jira_url,
             jira_email     = jira_email,
             jira_api_token = jira_token,

bob_dev-0.2.1/src/bob_dev/services/claude.py

@@ -0,0 +1,27 @@
+"""claude.py
+
+Claude Code utilities for bob_dev:
+  - List available agents from the Claude Code CLI.
+  - Run Claude Code commands and handle errors.
+"""
+
+import subprocess
+
+from ..services.terminal import print_error
+
+
+def read_agents_from_claude(claude_cmd: str) -> list[str]:
+    """Run *claude_cmd* with --list-agents and parse the output into a list."""
+    try:
+        result = subprocess.run(
+            [claude_cmd, "--list-agents"],
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,
+            text=True,
+            check=True,
+        )
+        agents = [line.strip() for line in result.stdout.splitlines() if line.strip()]
+        return agents
+    except Exception as exc:
+        print_error(f"Failed to list agents from Claude Code CLI: {exc}")
+        return []

bob_dev-0.1.0/src/bob_dev/helpers/config_helper.py → bob_dev-0.2.1/src/bob_dev/services/config.py

@@ -1,4 +1,4 @@
-"""config_helper.py
+"""config.py
 
 Configuration utilities for bob_dev:
   - Write / update key-value pairs in the .env file.
@@ -53,6 +53,9 @@ def check_configuration(
     agent: str,
     grok_api_key: str,
     openai_api_key: str,
+    gitlab_url: str,
+    gitlab_api_token: str,
+    task_manager: str,
     jira_url: str,
     jira_email: str,
     jira_api_token: str,
@@ -65,7 +68,7 @@ def check_configuration(
     # ── LLM API key ───────────────────────────────────────────────────────
     print_info(f"Checking {agent} API key …")
     try:
-        from .llm_helper import build_llm_client, llm_model
+        from .llm import build_llm_client, llm_model
 
         client   = build_llm_client(agent, grok_api_key, openai_api_key)
         model    = llm_model(agent)
@@ -79,16 +82,29 @@ def check_configuration(
     except Exception as exc:
         print_error(f"Failed to connect to {agent} API: {exc}")
 
-    # ── Jira credentials ──────────────────────────────────────────────────
-    print_info("Checking Jira credentials …")
-    try:
-        from atlassian import Jira
-
-        jira = Jira(url=jira_url, username=jira_email, password=jira_api_token, cloud=True)
-        user = jira.myself()
-        print_success(f"Jira credentials OK. Authenticated as: {user.get('displayName')}")
-    except Exception as exc:
-        print_error(f"Failed to connect to Jira: {exc}")
+    if task_manager == "GITLAB":
+        # ── GitLab credentials ───────────────────────────────────────────────
+        print_info("Checking GitLab credentials …")
+        try:
+            from gitlab import Gitlab
+
+            gl = Gitlab(url=gitlab_url, private_token=gitlab_api_token)
+            user = gl.user
+            print_success(f"GitLab credentials OK. Authenticated as: {user['name']}")
+        except Exception as exc:
+            print_error(f"Failed to connect to GitLab: {exc}")
+    
+    if task_manager == "JIRA":
+        # ── Jira credentials ──────────────────────────────────────────────────
+        print_info("Checking Jira credentials …")
+        try:
+            from atlassian import Jira
+
+            jira = Jira(url=jira_url, username=jira_email, password=jira_api_token, cloud=True)
+            user = jira.myself()
+            print_success(f"Jira credentials OK. Authenticated as: {user.get('displayName')}")
+        except Exception as exc:
+            print_error(f"Failed to connect to Jira: {exc}")
 
     # ── Claude Code CLI ───────────────────────────────────────────────────
     print_info(f"Checking Claude Code CLI ({claude_cmd}) …")

bob_dev-0.2.1/src/bob_dev/services/gitlab.py

@@ -0,0 +1,42 @@
+"""gitlab.py
+
+GitLab integration utilities for bob_dev:
+  - Fetch a GitLab issue and normalise its fields into a plain dict.
+"""
+
+from __future__ import annotations
+
+import gitlab
+
+
+def get_gitlab_task(
+    task_id: int | str,
+    gitlab_url: str,
+    gitlab_token: str,
+    project_id: int | str,
+) -> dict:
+    """Connect to a GitLab instance and return normalised fields for *task_id*.
+
+    *task_id* is the issue IID (the number shown in the GitLab UI, e.g. #42).
+    *project_id* can be the numeric ID or the path namespace, e.g. "group/repo".
+
+    Returns a dict with keys:
+        task_id      (str)
+        title        (str)
+        description  (str)
+        fix_versions (list[str]  – milestone title wrapped in a list, or empty)
+    """
+    gl = gitlab.Gitlab(url=gitlab_url, private_token=gitlab_token)
+
+    project = gl.projects.get(project_id)
+    issue   = project.issues.get(int(task_id))
+
+    milestone     = issue.milestone or {}
+    fix_versions  = [milestone["title"]] if milestone.get("title") else []
+
+    return {
+        "task_id":      str(task_id),
+        "title":        issue.title or "",
+        "description":  issue.description or "",
+        "fix_versions": fix_versions,
+    }

bob_dev-0.1.0/src/bob_dev/helpers/jira_helper.py → bob_dev-0.2.1/src/bob_dev/services/jira.py

@@ -1,4 +1,4 @@
-"""jira_helper.py
+"""jira.py
 
 Jira integration utilities for bob_dev:
   - Fetch a Jira issue and normalise its fields into a plain dict.

bob_dev-0.1.0/src/bob_dev/helpers/llm_helper.py → bob_dev-0.2.1/src/bob_dev/services/llm.py

@@ -1,4 +1,4 @@
-"""llm_helper.py
+"""llm.py
 
 LLM integration for bob_dev:
   - Build an OpenAI-compatible client for GROK or OpenAI backends.

bob_dev-0.1.0/src/bob_dev/helpers/project_helper.py → bob_dev-0.2.1/src/bob_dev/services/project.py

@@ -1,4 +1,4 @@
-"""project_helper.py
+"""project.py
 
 Project context utilities for bob_dev:
   - Collect Markdown files from the repository for LLM context.

{bob_dev-0.1.0 → bob_dev-0.2.1/src/bob_dev.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bob-dev
-Version: 0.1.0
+Version: 0.2.1
 Summary: An AI developer to write code for you
 Author-email: Samuel Pereira dos Santos <samuelsantosdev@gmail.com>
 Requires-Python: >=3.14
@@ -17,21 +17,22 @@ Dynamic: license-file
 
 ![BOB-Dev Banner](https://github.com/samuelsantosdev/bob-dev/blob/main/assets/banner.png)
 
-Given a Jira task ID it will:
+Given a task ID (Jira or GitLab) it will:
 
-1. **Fetch** the task title, description, and fix versions from Jira.
+1. **Fetch** the task title, description, and fix versions from Jira or GitLab.
 2. **Read** your project's Markdown documentation to build rich LLM context.
 3. **Generate** a precise Claude Code prompt (via GROK or OpenAI), including project-framework context, implementation steps, and test scenarios.
 4. **Analyse** the prompt for ambiguities and security concerns.
-5. **Execute** the prompt with the Claude Code CLI (optional – you can review first).
+5. **Select** (optionally) a Claude Code agent to run the implementation.
+6. **Execute** the prompt with the Claude Code CLI (optional – you can review first).
 
 ---
 
 ## Requirements
 
-- Python 3.11+
+- Python 3.14+
 - [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and available on `$PATH` as `claude`
-- A Jira Cloud account with an [API token](https://id.atlassian.com/manage-profile/security/api-tokens)
+- A **Jira Cloud** account with an [API token](https://id.atlassian.com/manage-profile/security/api-tokens) **or** a **GitLab** account with a [personal access token](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)
 - An [xAI / GROK](https://console.x.ai/) **or** [OpenAI](https://platform.openai.com/) API key
 
 ---
@@ -52,19 +53,37 @@ Run the interactive setup wizard the first time:
 bob-dev --configure
 ```
 
-This will prompt for your API keys, Jira credentials, and Claude Code API key.
+This will prompt for your LLM API key, task manager (Jira or GitLab) credentials, and Claude Code API key.
+
+### Environment variables
+
+| Variable | Description |
+|----------|-------------|
+| `AGENT` | LLM backend: `GROK` (default) or `OPENAI` |
+| `GROK_API_KEY` | xAI / GROK secret key |
+| `OPENAI_API_KEY` | OpenAI secret key |
+| `TASK_MANAGER` | Task manager: `JIRA` (default) or `GITLAB` |
+| `JIRA_URL` | e.g. `https://your-org.atlassian.net` |
+| `JIRA_EMAIL` | Atlassian account e-mail |
+| `JIRA_API_TOKEN` | Atlassian API token |
+| `GITLAB_URL` | e.g. `https://gitlab.com` |
+| `GITLAB_API_TOKEN` | GitLab personal access token |
 
 ---
 
 ## Usage
 
 ```bash
+# Jira
 bob-dev --task_id PROJ-123 --path /path/to/your/repo
+
+# GitLab (issue IID)
+bob-dev --task_id 42 --path /path/to/your/repo
 ```
 
 | Flag | Description |
 |------|-------------|
-| `--task_id` | Jira task ID to process (required for normal workflow) |
+| `--task_id` | Task ID to process — Jira key (`PROJ-123`) or GitLab issue IID (`42`) |
 | `--path` | Path to the target repository (default: current directory) |
 | `--agent` | LLM backend: `GROK` or `OPENAI` (default: value of `AGENT` in `.env`) |
 | `--configure` | Run the interactive configuration wizard |
@@ -76,12 +95,14 @@ bob-dev --task_id PROJ-123 --path /path/to/your/repo
 ```
 src/bob_dev/
 ├── cli.py                  # Entry point & main workflow orchestration
-├── helpers/
+├── services/
 │   ├── terminal.py         # ANSI colours, print helpers, spinner animation
-│   ├── jira_helper.py      # Jira API connection + ADF-to-text parsing
-│   ├── llm_helper.py       # LLM client, model selection, prompt generation
-│   ├── project_helper.py   # Markdown context collection + framework detection
-│   └── config_helper.py    # .env management + credential validation
+│   ├── jira.py             # Jira API connection + ADF-to-text parsing
+│   ├── gitlab.py           # GitLab API connection via python-gitlab
+│   ├── claude.py           # Claude Code CLI utilities (agent listing)
+│   ├── llm.py              # LLM client, model selection, prompt generation
+│   ├── project.py          # Markdown context collection + framework detection
+│   └── config.py           # .env management + credential validation
 └── constants/
     └── frameworks.py       # Known framework names used for auto-detection
 ```

{bob_dev-0.1.0 → bob_dev-0.2.1}/src/bob_dev.egg-info/SOURCES.txt

@@ -12,15 +12,17 @@ src/bob_dev.egg-info/requires.txt
 src/bob_dev.egg-info/top_level.txt
 src/bob_dev/constants/__init__.py
 src/bob_dev/constants/frameworks.py
-src/bob_dev/helpers/__init__.py
-src/bob_dev/helpers/config_helper.py
-src/bob_dev/helpers/jira_helper.py
-src/bob_dev/helpers/llm_helper.py
-src/bob_dev/helpers/project_helper.py
-src/bob_dev/helpers/terminal.py
+src/bob_dev/services/__init__.py
+src/bob_dev/services/claude.py
+src/bob_dev/services/config.py
+src/bob_dev/services/gitlab.py
+src/bob_dev/services/jira.py
+src/bob_dev/services/llm.py
+src/bob_dev/services/project.py
+src/bob_dev/services/terminal.py
 tests/test_cli.py
-tests/test_config_helper.py
-tests/test_jira_helper.py
-tests/test_llm_helper.py
-tests/test_project_helper.py
+tests/test_config.py
+tests/test_jira.py
+tests/test_llm.py
+tests/test_project.py
 tests/test_terminal.py

bob_dev-0.1.0/tests/test_config_helper.py → bob_dev-0.2.1/tests/test_config.py

@@ -1,4 +1,4 @@
-"""Tests for bob_dev.helpers.config_helper."""
+"""Tests for bob_dev.services.config."""
 
 from __future__ import annotations
 
@@ -6,7 +6,7 @@ import os
 
 import pytest
 
-from bob_dev.helpers.config_helper import update_env_file
+from bob_dev.services.config import update_env_file
 
 
 class TestUpdateEnvFile:

bob_dev-0.1.0/tests/test_jira_helper.py → bob_dev-0.2.1/tests/test_jira.py

@@ -1,4 +1,4 @@
-"""Tests for bob_dev.helpers.jira_helper."""
+"""Tests for bob_dev.services.jira."""
 
 from __future__ import annotations
 
@@ -6,7 +6,7 @@ from unittest.mock import MagicMock, patch
 
 import pytest
 
-from bob_dev.helpers.jira_helper import _adf_to_text, get_jira_task
+from bob_dev.services.jira import _adf_to_text, get_jira_task
 
 
 class TestAdfToText:
@@ -128,32 +128,32 @@ class TestGetJiraTask:
         }
         return mock_jira
 
-    @patch("bob_dev.helpers.jira_helper.Jira")
+    @patch("bob_dev.services.jira.Jira")
     def test_returns_required_keys(self, mock_jira_cls):
         mock_jira_cls.return_value = self._build_mock_jira()
         result = get_jira_task("PROJ-1", "https://example.atlassian.net", "u@e.com", "tok")
         for key in ("task_id", "title", "description", "fix_versions"):
             assert key in result
 
-    @patch("bob_dev.helpers.jira_helper.Jira")
+    @patch("bob_dev.services.jira.Jira")
     def test_task_id_preserved(self, mock_jira_cls):
         mock_jira_cls.return_value = self._build_mock_jira()
         result = get_jira_task("PROJ-42", "https://example.atlassian.net", "u@e.com", "tok")
         assert result["task_id"] == "PROJ-42"
 
-    @patch("bob_dev.helpers.jira_helper.Jira")
+    @patch("bob_dev.services.jira.Jira")
     def test_title_extracted(self, mock_jira_cls):
         mock_jira_cls.return_value = self._build_mock_jira(summary="My Task Title")
         result = get_jira_task("PROJ-1", "https://example.atlassian.net", "u@e.com", "tok")
         assert result["title"] == "My Task Title"
 
-    @patch("bob_dev.helpers.jira_helper.Jira")
+    @patch("bob_dev.services.jira.Jira")
     def test_plain_text_description_passed_through(self, mock_jira_cls):
         mock_jira_cls.return_value = self._build_mock_jira(description="Plain description")
         result = get_jira_task("PROJ-1", "https://example.atlassian.net", "u@e.com", "tok")
         assert result["description"] == "Plain description"
 
-    @patch("bob_dev.helpers.jira_helper.Jira")
+    @patch("bob_dev.services.jira.Jira")
     def test_adf_description_parsed_to_text(self, mock_jira_cls):
         adf = {
             "type": "doc",
@@ -168,7 +168,7 @@ class TestGetJiraTask:
         result = get_jira_task("PROJ-1", "https://example.atlassian.net", "u@e.com", "tok")
         assert "ADF content" in result["description"]
 
-    @patch("bob_dev.helpers.jira_helper.Jira")
+    @patch("bob_dev.services.jira.Jira")
     def test_fix_versions_extracted(self, mock_jira_cls):
         mock_jira_cls.return_value = self._build_mock_jira(
             fix_versions=[{"name": "v1.0"}, {"name": "v1.1"}]
@@ -176,13 +176,13 @@ class TestGetJiraTask:
         result = get_jira_task("PROJ-1", "https://example.atlassian.net", "u@e.com", "tok")
         assert result["fix_versions"] == ["v1.0", "v1.1"]
 
-    @patch("bob_dev.helpers.jira_helper.Jira")
+    @patch("bob_dev.services.jira.Jira")
     def test_empty_fix_versions(self, mock_jira_cls):
         mock_jira_cls.return_value = self._build_mock_jira(fix_versions=[])
         result = get_jira_task("PROJ-1", "https://example.atlassian.net", "u@e.com", "tok")
         assert result["fix_versions"] == []
 
-    @patch("bob_dev.helpers.jira_helper.Jira")
+    @patch("bob_dev.services.jira.Jira")
     def test_none_description_becomes_empty_string(self, mock_jira_cls):
         mock_jira = MagicMock()
         mock_jira.issue.return_value = {
@@ -196,7 +196,7 @@ class TestGetJiraTask:
         result = get_jira_task("PROJ-1", "https://example.atlassian.net", "u@e.com", "tok")
         assert result["description"] == ""
 
-    @patch("bob_dev.helpers.jira_helper.Jira")
+    @patch("bob_dev.services.jira.Jira")
     def test_jira_instantiated_with_cloud_true(self, mock_jira_cls):
         mock_jira_cls.return_value = self._build_mock_jira()
         get_jira_task("PROJ-1", "https://org.atlassian.net", "user@test.com", "token123")

bob_dev-0.1.0/tests/test_llm_helper.py → bob_dev-0.2.1/tests/test_llm.py

@@ -1,4 +1,4 @@
-"""Tests for bob_dev.helpers.llm_helper."""
+"""Tests for bob_dev.services.llm."""
 
 from __future__ import annotations
 
@@ -6,7 +6,7 @@ from unittest.mock import MagicMock, patch
 
 import pytest
 
-from bob_dev.helpers.llm_helper import (
+from bob_dev.services.llm import (
     analyse_prompt,
     build_llm_client,
     llm_model,
@@ -35,25 +35,25 @@ class TestBuildLlmClient:
         with pytest.raises(EnvironmentError, match="OPENAI_API_KEY"):
             build_llm_client("OPENAI", "", "")
 
-    @patch("bob_dev.helpers.llm_helper.OpenAI")
+    @patch("bob_dev.services.llm.OpenAI")
     def test_grok_sets_xai_base_url(self, mock_openai_cls):
         build_llm_client("GROK", "grok-key-123", "")
         _, kwargs = mock_openai_cls.call_args
         assert "x.ai" in kwargs.get("base_url", "")
 
-    @patch("bob_dev.helpers.llm_helper.OpenAI")
+    @patch("bob_dev.services.llm.OpenAI")
     def test_grok_passes_api_key(self, mock_openai_cls):
         build_llm_client("GROK", "my-grok-key", "")
         _, kwargs = mock_openai_cls.call_args
         assert kwargs.get("api_key") == "my-grok-key"
 
-    @patch("bob_dev.helpers.llm_helper.OpenAI")
+    @patch("bob_dev.services.llm.OpenAI")
     def test_openai_no_base_url(self, mock_openai_cls):
         build_llm_client("OPENAI", "", "openai-key-123")
         _, kwargs = mock_openai_cls.call_args
         assert "base_url" not in kwargs
 
-    @patch("bob_dev.helpers.llm_helper.OpenAI")
+    @patch("bob_dev.services.llm.OpenAI")
     def test_openai_passes_api_key(self, mock_openai_cls):
         build_llm_client("OPENAI", "", "openai-secret")
         _, kwargs = mock_openai_cls.call_args
@@ -70,7 +70,7 @@ def _make_mock_client(content: str) -> MagicMock:
 
 
 class TestPromptClaudeCode:
-    @patch("bob_dev.helpers.llm_helper.build_llm_client")
+    @patch("bob_dev.services.llm.build_llm_client")
     def test_returns_llm_content(self, mock_build):
         mock_build.return_value = _make_mock_client("My generated prompt")
         result = prompt_claude_code(
@@ -83,20 +83,20 @@ class TestPromptClaudeCode:
         )
         assert result == "My generated prompt"
 
-    @patch("bob_dev.helpers.llm_helper.build_llm_client")
+    @patch("bob_dev.services.llm.build_llm_client")
     def test_returns_empty_string_when_content_is_none(self, mock_build):
         mock_build.return_value = _make_mock_client(None)
         result = prompt_claude_code("AC", "docs", "Django", "GROK", "key", "")
         assert result == ""
 
-    @patch("bob_dev.helpers.llm_helper.build_llm_client")
+    @patch("bob_dev.services.llm.build_llm_client")
     def test_calls_create_with_temperature(self, mock_build):
         mock_build.return_value = _make_mock_client("ok")
         prompt_claude_code("AC", "docs", "FastAPI", "OPENAI", "", "key")
         create_kwargs = mock_build.return_value.chat.completions.create.call_args[1]
         assert "temperature" in create_kwargs
 
-    @patch("bob_dev.helpers.llm_helper.build_llm_client")
+    @patch("bob_dev.services.llm.build_llm_client")
     def test_task_meta_injected_into_user_message(self, mock_build):
         mock_client = _make_mock_client("prompt with meta")
         mock_build.return_value = mock_client
@@ -115,14 +115,14 @@ class TestPromptClaudeCode:
         assert "PROJ-1" in user_content
         assert "Test task" in user_content
 
-    @patch("bob_dev.helpers.llm_helper.build_llm_client")
+    @patch("bob_dev.services.llm.build_llm_client")
     def test_task_meta_none_does_not_raise(self, mock_build):
         mock_build.return_value = _make_mock_client("ok")
         # Should not raise when task_meta is omitted.
         result = prompt_claude_code("AC", "docs", "Django", "GROK", "key", "")
         assert isinstance(result, str)
 
-    @patch("bob_dev.helpers.llm_helper.build_llm_client")
+    @patch("bob_dev.services.llm.build_llm_client")
     def test_framework_included_in_system_prompt(self, mock_build):
         mock_client = _make_mock_client("ok")
         mock_build.return_value = mock_client
@@ -133,19 +133,19 @@ class TestPromptClaudeCode:
 
 
 class TestAnalysePrompt:
-    @patch("bob_dev.helpers.llm_helper.build_llm_client")
+    @patch("bob_dev.services.llm.build_llm_client")
     def test_returns_analysis_string(self, mock_build):
         mock_build.return_value = _make_mock_client("- No issues found")
         result = analyse_prompt("prompt md", "AC text", "GROK", "key", "")
         assert result == "- No issues found"
 
-    @patch("bob_dev.helpers.llm_helper.build_llm_client")
+    @patch("bob_dev.services.llm.build_llm_client")
     def test_returns_empty_string_when_content_is_none(self, mock_build):
         mock_build.return_value = _make_mock_client(None)
         result = analyse_prompt("prompt", "AC", "GROK", "key", "")
         assert result == ""
 
-    @patch("bob_dev.helpers.llm_helper.build_llm_client")
+    @patch("bob_dev.services.llm.build_llm_client")
     def test_passes_prompt_and_ac_to_user_message(self, mock_build):
         mock_client = _make_mock_client("analysis")
         mock_build.return_value = mock_client
@@ -155,7 +155,7 @@ class TestAnalysePrompt:
         assert "the prompt content" in user_content
         assert "the AC content" in user_content
 
-    @patch("bob_dev.helpers.llm_helper.build_llm_client")
+    @patch("bob_dev.services.llm.build_llm_client")
     def test_calls_create_with_temperature(self, mock_build):
         mock_build.return_value = _make_mock_client("ok")
         analyse_prompt("p", "ac", "GROK", "key", "")

bob_dev-0.1.0/tests/test_project_helper.py → bob_dev-0.2.1/tests/test_project.py

@@ -1,4 +1,4 @@
-"""Tests for bob_dev.helpers.project_helper."""
+"""Tests for bob_dev.services.project."""
 
 from __future__ import annotations
 
@@ -7,7 +7,7 @@ from unittest.mock import patch
 
 import pytest
 
-from bob_dev.helpers.project_helper import (
+from bob_dev.services.project import (
     build_md_context,
     collect_md_context,
     identify_framework,
@@ -102,14 +102,14 @@ class TestBuildMdContext:
         result = build_md_context(tmp_path)
         assert "API documentation" in result
 
-    @patch("bob_dev.helpers.project_helper.summarize")
+    @patch("bob_dev.services.project.summarize")
     def test_readme_summary_included(self, mock_summarize, tmp_path):
         (tmp_path / "README.md").write_text("# Django REST Framework")
         mock_summarize.return_value = "Summary text"
         result = build_md_context(tmp_path)
         assert "Summary text" in result
 
-    @patch("bob_dev.helpers.project_helper.summarize")
+    @patch("bob_dev.services.project.summarize")
     def test_summarize_called_with_readme_content(self, mock_summarize, tmp_path):
         (tmp_path / "README.md").write_text("readme body")
         mock_summarize.return_value = ""
@@ -119,7 +119,7 @@ class TestBuildMdContext:
         assert "readme body" in args[0]
 
     def test_empty_readme_does_not_call_summarize(self, tmp_path):
-        with patch("bob_dev.helpers.project_helper.summarize") as mock_summarize:
+        with patch("bob_dev.services.project.summarize") as mock_summarize:
             build_md_context(tmp_path)
         mock_summarize.assert_not_called()
 

{bob_dev-0.1.0 → bob_dev-0.2.1}/tests/test_terminal.py

@@ -1,4 +1,4 @@
-"""Tests for bob_dev.helpers.terminal."""
+"""Tests for bob_dev.services.terminal."""
 
 from __future__ import annotations
 
@@ -6,7 +6,7 @@ import asyncio
 
 import pytest
 
-from bob_dev.helpers.terminal import (
+from bob_dev.services.terminal import (
     BOLD,
     GREEN,
     RED,