🤙 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.
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 nowyeaboion PyPI, matching the command. A finalscrum-agentrelease remains as a thin redirect that installsyeaboi, and the legacyscrum-agentcommand still works as an alias for that release — but new installs should useyeaboi.
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-whisper — no API key, works with every LLM provider (Anthropic, Bedrock, …). On macOS/Windows the
[voice]extra is fully self-contained (thesounddevicewheel 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 defaultbase; setVOICE_MODELtotiny/small/medium/large-v3to 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, sobrew install yeaboiis intentionally disabled. Useuv tool installorpipx installabove 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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file yeaboi-2.57.0.tar.gz.
File metadata
- Download URL: yeaboi-2.57.0.tar.gz
- Upload date:
- Size: 36.9 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7f0be2f01a9e866da060e12a338576456a98a5bef9f13f32b406d7d13182105c
|
|
| MD5 |
cbbc8c25333f34f6539cf5a2063439bc
|
|
| BLAKE2b-256 |
75bf510b8c4afe8b29156836a79683777d723ebe14e32790d07784ff06edb9eb
|
Provenance
The following attestation bundles were made for yeaboi-2.57.0.tar.gz:
Publisher:
publish.yml on dinho149/yeaboi.ai
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
yeaboi-2.57.0.tar.gz -
Subject digest:
7f0be2f01a9e866da060e12a338576456a98a5bef9f13f32b406d7d13182105c - Sigstore transparency entry: 2381498536
- Sigstore integration time:
-
Permalink:
dinho149/yeaboi.ai@f0d4a3700b5bd0335475c4b758e41112303f030f -
Branch / Tag:
refs/heads/main - Owner: https://github.com/dinho149
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@f0d4a3700b5bd0335475c4b758e41112303f030f -
Trigger Event:
push
-
Statement type:
File details
Details for the file yeaboi-2.57.0-py3-none-any.whl.
File metadata
- Download URL: yeaboi-2.57.0-py3-none-any.whl
- Upload date:
- Size: 2.2 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3a70cc4a7d71faa895bbc95ead7287f77a293c531f521ccd3b5dcbf522243fcd
|
|
| MD5 |
339edf6c4020a3a6bfd14936d4606649
|
|
| BLAKE2b-256 |
d2ce1bba6060759b5ac132056a4784da41df9a707d061f41b3164a32a79a329d
|
Provenance
The following attestation bundles were made for yeaboi-2.57.0-py3-none-any.whl:
Publisher:
publish.yml on dinho149/yeaboi.ai
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
yeaboi-2.57.0-py3-none-any.whl -
Subject digest:
3a70cc4a7d71faa895bbc95ead7287f77a293c531f521ccd3b5dcbf522243fcd - Sigstore transparency entry: 2381499260
- Sigstore integration time:
-
Permalink:
dinho149/yeaboi.ai@f0d4a3700b5bd0335475c4b758e41112303f030f -
Branch / Tag:
refs/heads/main - Owner: https://github.com/dinho149
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@f0d4a3700b5bd0335475c4b758e41112303f030f -
Trigger Event:
push
-
Statement type:
