Metadata-Version: 2.4
Name: bees-md
Version: 0.9.1
Summary: A markdown-based ticket management system designed for LLMs
License: MIT
License-File: LICENSE
Keywords: tickets,task-management,mcp,llm,ai
Author: Gabe Mahoney
Requires-Python: >=3.10
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development
Classifier: Environment :: Console
Provides-Extra: serve
Requires-Dist: fastmcp (>=3.0.2,<4) ; extra == "serve"
Requires-Dist: mcp (>=1.24.0,<2) ; extra == "serve"
Requires-Dist: pyyaml (>=6.0)
Project-URL: Homepage, https://github.com/gabemahoney/bees
Project-URL: Repository, https://github.com/gabemahoney/bees
Description-Content-Type: text/markdown

## Overview

Bees is a markdown-based ticket management system for LLM-assisted development. After install the `bees` command is available in your shell.

## Installation

```bash
# CLI only
pipx install bees-md

# CLI + MCP server (required for bees serve)
pipx install 'bees-md[serve]'
```

Check the installed version:

```bash
bees --version
```

## Upgrade

Reinstall instead of upgrading in place. An in-place upgrade (`pipx upgrade`, `pipx install --force`, `pip install -U`) can leave the MCP server's `fastmcp` package half-installed, and `bees serve` then cannot start.

```bash
pipx uninstall bees-md
pipx install 'bees-md[serve]'
```

With pip instead of pipx:

```bash
python -m pip uninstall -y bees-md fastmcp fastmcp-slim mcp
python -m pip install 'bees-md[serve]'
```

## Documentation

Full docs at [github.com/gabemahoney/bees](https://github.com/gabemahoney/bees)

## Changelog

See [Releases](https://github.com/gabemahoney/bees/releases) for version history and release notes.

