Summary

Tau is a minimalist, readable terminal coding agent and educational project designed to demystify coding agent system architecture. It empowers engineers, researchers, and power users by providing a functional agent while serving as a transparent example of agent construction, avoiding the complexity of large production codebases.

How It Works

Tau utilizes a layered, event-driven architecture: tau_ai abstracts model providers, tau_agent contains the core portable brain (messages, tools, events, loop, harness, session primitives), and tau_coding provides the frontend (CLI, TUI, tools). This design emphasizes small, readable layers and uses events as the central contract. The core AgentHarness is decoupled from specific frontends and rendering libraries, promoting reusability. Tools are typed functions, and sessions are durable, append-only JSONL files.

Quick Start & Requirements

Install via uv tool install tau-ai. For local development, clone the repo, sync dependencies (uv sync --dev), and run using uv run tau. To use Tau, navigate to your project directory and run tau (interactive TUI) or tau -p "prompt" (one-shot mode). Tau requires a configured language model provider; connect via /login (supports OpenAI, Anthropic, Hugging Face, OpenRouter, local compatible endpoints). Documentation: https://twotimespi.dev/.

Highlighted Details

• Interactive Textual TUI and non-interactive print mode.
• Built-in coding tools: read, write, edit, bash.
• Durable JSONL sessions with resume/branching (~/.tau/sessions/).
• Provider-neutral event rendering (Rich, plain text, JSON, custom).
• Project instructions from AGENTS.md, .tau/, .agents/.
• User skills and prompt templates.
• Context accounting with manual/automatic compaction.

Maintenance & Community

The implementation roadmap is tracked via GitHub issue #1. No specific community channels or notable contributors/sponsorships are detailed in the README.

Licensing & Compatibility

Released under the permissive MIT License, allowing for commercial use and integration into closed-source projects.

Limitations & Caveats

Tau is under active development, implying potential instability. Functionality requires user configuration of a supported language model provider. Roadmap tracking via a GitHub issue suggests a less formalized project management approach.