Metadata-Version: 2.4
Name: ffwf-tau
Version: 0.9.5
Summary: τ: the guessable name. Installs ffwf-tau-coding-agent[tui] — the `tau` command with its TUI.
Author: Fight Fire with Fire Robotics, LLC
License-Expression: MIT
Project-URL: Homepage, https://ffwfrobotics.github.io/tau/
Project-URL: Documentation, https://ffwfrobotics.github.io/tau/
Project-URL: Repository, https://github.com/jmccardle/tau
Project-URL: Issues, https://github.com/jmccardle/tau/issues
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: ffwf-tau-coding-agent[tui]==0.9.5
Dynamic: license-file

# ffwf-tau

The guessable name for **Tau**, a programmable coding-agent harness with an
optional TUI.

```bash
pip install ffwf-tau
tau
```

This distribution contains no code. It depends on
`ffwf-tau-coding-agent[tui]` at the same version and nothing else, so the two
commands above install the `tau` program with its interface and start it.

## Why it exists

Tau publishes four distributions, and none of them is called `ffwf-tau`:

| Distribution | Imports as | What it is |
|---|---|---|
| `ffwf-tau-llm` | `tau_llm` | the provider and streaming layer |
| `ffwf-tau-agent-core` | `tau_agent_core` | the agent loop, tools, sessions, extensions |
| `ffwf-tau-coding-agent` | `tau_coding_agent` | the `tau` command and the Textual TUI |
| `ffwf-tau-jmfts` | `tau_jmfts` | the optional JMFTS session store |

`pip install ffwf-tau` used to fail with `could not find a version that
satisfies the requirement`, which reads as "wrong Python" or "wrong index" and
is neither. It also matches the name of a command Tau already installs: the
`ffwf-tau` executable is the prefixed spelling of `tau`, for scripts that need a
name PyPI guarantees. One name now means one thing in both places.

Note the `ffwf-` prefix throughout. `tau`, `tau-llm`, and `tau-ai` on PyPI are
unrelated projects.

## What you get, and what you do not

`ffwf-tau` resolves to `ffwf-tau-coding-agent[tui]`: the CLI, the headless
modes, and the Textual interface.

It deliberately does **not** pull in `[jmfts]`. The JMFTS session store needs a
running server, so an install that added it by default would answer a question
nobody asked. Install it when you want it:

```bash
pip install 'ffwf-tau-coding-agent[tui,jmfts]'
```

If you want the headless agent without any interface libraries — 15 packages
instead of 27 — install the real distribution rather than this one:

```bash
pip install ffwf-tau-coding-agent
```

## Everything else

Documentation: <https://ffwfrobotics.github.io/tau/>

Repository: <https://github.com/jmccardle/tau>

MIT © Fight Fire with Fire Robotics, LLC
