BOB Dev

BOB Dev is an AI-powered developer workflow CLI that bridges task requirements, your codebase, and Claude Code.

Given a task ID (Jira or GitLab) it will:

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. Detect the project framework (Django, React, FastAPI, Spring Boot, and more).
4. Generate a precise Claude Code prompt (via GROK or OpenAI), including framework context, implementation steps, and test scenarios.
5. Analyse the prompt for ambiguities and security concerns.
6. Select (optionally) a Claude Code agent to run the implementation.
7. Execute the prompt with the Claude Code CLI (optional — you can review and edit first).

Requirements

• Python 3.12+
• Claude Code CLI installed and available on $PATH as claude
• A Jira Cloud account with an API token or a GitLab account with a personal access token
• An xAI / GROK or OpenAI API key

Installation

pip install bob-dev

Configuration

Run the interactive setup wizard the first time:

bob-dev --configure

This prompts for your LLM backend, API key, task manager (Jira or GitLab), and their credentials. All values are saved to ~/.bob_dev/.env.

Environment variables

Required

Jira (TASK_MANAGER=JIRA)

GitLab (TASK_MANAGER=GITLAB)

Optional

Usage

# 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

Project structure

src/bob_dev/
├── cli.py                  # Entry point & main workflow orchestration
├── settings.py             # Environment variable loading and validation
├── services/
│   ├── terminal.py         # ANSI colours, print helpers, spinner animation
│   ├── 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

tests/
├── test_cli.py
├── test_config.py
├── test_jira.py
├── test_llm.py
├── test_project.py
└── test_terminal.py

Running tests

pytest tests/

Colour conventions

License

MIT