bob-dev 0.2.2

An AI developer to write code for you

BOB Dev

BOB Dev is an AI-powered developer workflow CLI that bridges a 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. 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. 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.14+
• 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 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

# 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	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

---

Project structure

src/bob_dev/
├── cli.py                  # Entry point & main workflow orchestration
├── 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

---

Colour conventions

Colour	Meaning
Red	Errors that stop execution
Green	Success messages
Plain	Informational / default output

---

License

MIT