Skip to main content

yeaboi — an AI Scrum Master for your terminal: sprint planning, standups, retros, planning poker, 1:1s and delivery reports.

Project description

yeaboi.ai

🤙 yeaboi.ai

A team lead's best friend — plans, standups, retros, performance & reporting, right from your terminal. It decomposes projects into epics, stories, tasks, and sprint plans, then helps you run the team around them.

PyPI Python License Powered by Claude Built with LangGraph

Tests PyPI


yeaboi.ai demo — from project description to sprint plan

From project description to sprint plan in under a minute.


🚀 Quick Start

Recommended: uv or pipx

The most reliable way to install — pulls the full dependency tree from PyPI and isolates it in its own environment:

uv tool install yeaboi          # or: pipx install yeaboi
yeaboi --setup                  # configure your API key
yeaboi                          # launch the interactive TUI

Note on names: the package was previously published as scrum-agent. It is now yeaboi on PyPI, matching the command. A final scrum-agent release remains as a thin redirect that installs yeaboi, and the legacy scrum-agent command still works as an alias for that release — but new installs should use yeaboi.

Optional extras (voice input, extra LLM providers) can be requested at install time:

uv tool install "yeaboi[voice]"                # 🎤 dictate answers (double-tap Space) — offline, works with any LLM
uv tool install "yeaboi[all-providers]"        # OpenAI, Google, and Bedrock providers
pipx install "yeaboi[voice]"                   # equivalent with pipx

Voice input transcribes on-device with faster-whisperno API key, works with every LLM provider (Anthropic, Bedrock, …). On macOS/Windows the [voice] extra is fully self-contained (the sounddevice wheel bundles PortAudio). On Linux, also install the system library: sudo apt install libportaudio2. A small Whisper model downloads on first use (~140 MB for the default base; set VOICE_MODEL to tiny/small/medium/large-v3 to trade size for accuracy).

Homebrew is not supported. A required dependency (sqlite-vec) ships no source distribution, which Homebrew's source-build model can't handle, so brew install yeaboi is intentionally disabled. Use uv tool install or pipx install above instead.

From source

git clone https://github.com/dinho149/yeaboi.ai.git
cd yeaboi.ai
make install        # installs uv, creates venv, installs dependencies
make env            # creates .env from .env.example — add your API key
make run            # launch the CLI

Headless / CI mode

yeaboi --non-interactive --description "Build a todo app" --output json
yeaboi --non-interactive --description @project-brief.txt --output html --team-size 5

✨ Features

🖥️ Full-screen TUI — Animated splash, mode selection, pipeline progress, dark/light themes 🧠 Smart Intake — Extracts answers from your project description, asks only what's missing — or feed it a whole quarterly roadmap with Roadmap Intake 🔄 Seven modes, one command — Planning, Daily Standup, Retro, Planning Poker, Performance (beta), Reporting, Team Analysis 🔌 37 tools — GitHub, Azure DevOps, Jira, Confluence, Notion, local codebase scanning, and more 📤 5 export formats — Markdown, HTML, JSON, Jira sync, Azure DevOps Boards sync 🤖 5 LLM providers — Claude (default), GPT, Gemini, AWS Bedrock, or fully local & keyless with Ollama 🧩 Every surface — TUI, CLI subcommands, MCP server, and a Claude Code plugin, with feature parity enforced in CI 💾 Session persistence — SQLite-backed sessions plus a saved-runs hub for past standups, retros, and reports 🛡️ Guardrails — Input/output validation, human-in-the-loop review at every stage

📖 Full Documentation

Getting started, the full CLI reference, every mode in depth, integrations, architecture, and deployment guides: yeaboi.ai/docs

📄 License

MIT License. See LICENSE for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yeaboi-2.51.0.tar.gz (36.7 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

yeaboi-2.51.0-py3-none-any.whl (2.1 MB view details)

Uploaded Python 3

File details

Details for the file yeaboi-2.51.0.tar.gz.

File metadata

  • Download URL: yeaboi-2.51.0.tar.gz
  • Upload date:
  • Size: 36.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for yeaboi-2.51.0.tar.gz
Algorithm Hash digest
SHA256 03749b8ab193301f9f5fae78841374134b2bdd8e26ad0ae07b1d2cf9f7802f7d
MD5 f07c6feeb7e83ecf70a98fbb4d2e5dd0
BLAKE2b-256 9dfedc1f1ab3bb2b567dcfc4208d6bece9aabc0e66263a1af6315e9e7ac217f2

See more details on using hashes here.

Provenance

The following attestation bundles were made for yeaboi-2.51.0.tar.gz:

Publisher: publish.yml on dinho149/yeaboi.ai

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file yeaboi-2.51.0-py3-none-any.whl.

File metadata

  • Download URL: yeaboi-2.51.0-py3-none-any.whl
  • Upload date:
  • Size: 2.1 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for yeaboi-2.51.0-py3-none-any.whl
Algorithm Hash digest
SHA256 67d030ac5de2dd1b497d8d826c7944399f261e853c7d3a541068894e8a35dbe1
MD5 2b26e40d0778a8d9075cd43a0b020740
BLAKE2b-256 7acfbdd86b38fc92dcfbc9647461e80b41839ad35f0b07b22260a679d04c7319

See more details on using hashes here.

Provenance

The following attestation bundles were made for yeaboi-2.51.0-py3-none-any.whl:

Publisher: publish.yml on dinho149/yeaboi.ai

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page