Metadata-Version: 2.4
Name: mahu
Version: 1.0.1
Summary: Agent skill router for context, prototypes, presentations, tests, and feedback loops
License-Expression: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.1
Provides-Extra: test
Requires-Dist: pytest>=8.0; extra == "test"
Requires-Dist: pytest-cov>=5.0; extra == "test"
Dynamic: license-file

# Mahu

<p align="center">
  <img src="mahu.png" alt="Mahu" width="320">
</p>

```text
I'm Mahu, your free AI work buddy for context, prototypes, tests, feedback, and growth.
Bring me into your daily workflow.
```

Mahu is not a single builder and not another chat persona. It is a lightweight
agent skill package that helps Codex, OpenCode, Copilot, WorkBuddy, and future
agents work through the right SOP instead of improvising every time.

Use `/mahu` when daily work needs structure: capture context, build a prototype,
create a presentation, test the result, publish it for feedback, or turn the
learning loop into growth momentum.

## What Mahu Helps With

| User intent | Mahu subskill | Owning tool |
| --- | --- | --- |
| context, memory, topics, requirements | `context` | `fcontext` |
| prototype, UI, website, app, design system | `prototype` | `fdesign` |
| deck, PPT, slides, presentation | `presentation` | `fppt` |
| review, feedback, comments, upload, resolve | `review` | `floop-client` |
| tests, QA, regression, acceptance | `test` | `testboat` |
| growth, iteration, learning loop | combine context, test, and feedback | Mahu SOP |

## Install By GitHub Link

The simplest install path is the same shape as `frontend-slides`: send your
agent the GitHub repo link and ask it to use Mahu.

The agent should:

1. Read top-level `SKILL.md`.
2. Classify the request.
3. Load only the referenced file under `skills/` that matches the request.
4. Follow that subskill SOP.

## Local CLI

```bash
mahu route "make a product prototype and upload for review"
mahu doctor --subskill prototype
mahu validate
mahu enable opencode --target .
```

Each Mahu subskill declares its own dependency. Before executing a routed
subskill, run `mahu doctor --subskill <name>` or check the required CLI
directly.

| Subskill | Required CLI | Typical install |
| --- | --- | --- |
| `context` | `fcontext` | `pip install fcontext` |
| `prototype` | `fdesign` | `pip install fdesign` |
| `presentation` | `fppt` | `pip install fppt` |
| `review` | `floop` | `pip install floop` |
| `test` | `testboat` | `pip install testboat` |

Supported enable targets:

- `codex`
- `workbuddy`
- `copilot`
- `opencode`

## Development

```bash
PYTHONPATH=src pytest --cov=mahu --cov-report=term-missing --cov-fail-under=100
```
