tau-coding-agent 0.1.0__tar.gz

tau_coding_agent-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jeomon George
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tau_coding_agent-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+recursive-include tau/builtins *
+recursive-include docs *
+include README.md
+include LICENSE

tau_coding_agent-0.1.0/PKG-INFO

@@ -0,0 +1,177 @@
+Metadata-Version: 2.4
+Name: tau-coding-agent
+Version: 0.1.0
+Summary: Interactive agent CLI with terminal UI for multi-provider LLM support
+Requires-Python: ==3.13.*
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: anthropic==0.109.1
+Requires-Dist: certifi==2026.5.20
+Requires-Dist: click==8.4.1
+Requires-Dist: filelock==3.29.3
+Requires-Dist: google-genai==2.8.0
+Requires-Dist: httpx==0.28.1
+Requires-Dist: mistralai==2.4.9
+Requires-Dist: ollama==0.6.2
+Requires-Dist: openai==2.41.1
+Requires-Dist: packaging==26.2
+Requires-Dist: pillow==12.2.0
+Requires-Dist: pydantic==2.13.4
+Requires-Dist: python-dotenv==1.2.2
+Requires-Dist: uuid7==0.1.0
+Requires-Dist: websockets==16.0
+Requires-Dist: mistletoe==1.5.1
+Requires-Dist: pyyaml==6.0.2
+Requires-Dist: pygments==2.20.0
+Requires-Dist: pathspec==1.1.1
+Requires-Dist: gitpython==3.1.50
+Dynamic: license-file
+
+# Tau
+
+Inspired by [Pi](https://pi.dev), Tau brings the same agent framework capabilities to Python developers. A self-extensible agent CLI with a terminal UI, multi-provider LLM support, session management with branching, and a plugin system for tools, commands, and customization.
+
+---
+
+## Quick Start
+
+### Installation
+
+```bash
+pip install tau-coding-agent
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/Jeomon/Tau.git
+cd Tau
+pip install -e .
+```
+
+### Launch
+
+```bash
+tau
+```
+
+Authenticate with your LLM provider using `/login` or set environment variables (e.g., `ANTHROPIC_API_KEY`).
+
+### Common Commands
+
+```bash
+tau                                           # Interactive mode
+tau --resume                                  # Resume most recent session
+tau --model claude-sonnet-4-6                 # Use specific model
+tau --print "Summarize this repo"             # One-shot mode
+tau -p anthropic --print "Explain this code"  # Print mode with provider
+tau --mode rpc                                # RPC mode for IDE extensions
+```
+
+> For detailed options, see [CLI Reference](docs/cli-reference.md)
+
+## Features
+
+- **Multi-provider LLM support** — Anthropic Claude, OpenAI GPT, Google Gemini, Mistral AI, Ollama, Azure OpenAI
+- **Terminal UI** — Built-in chat interface with syntax highlighting, markdown rendering, and keyboard navigation
+- **Rich media support** — Work with text files, images, audio files, and video files via file references or clipboard input
+- **Session management** — Persistent sessions with branching, forking, and resuming capabilities
+- **Tool execution** — Built-in tools (terminal, file I/O, web fetch) with sandboxed execution and extensibility
+- **Plugin system** — Add custom tools, slash commands, hooks, themes, and skills without modifying core code
+- **16 built-in themes** — Dark and light themes including dracula, nord, gruvbox, catppuccin, ayu-dark, tokyo-night, rose-pine, and more
+- **Context management** — Automatic context compaction and branch summarization for long conversations
+- **Python API** — Embed Tau in your own applications programmatically
+- **Multiple run modes** — Interactive TUI, print mode (one-shot), JSON event stream, and JSON-RPC for IDE integration
+
+## Documentation
+
+Start here: [**Tau Documentation**](docs/index.md)
+
+**Key resources:**
+- [Quickstart](docs/quickstart.md) — Five-minute getting started guide
+- [Installation & Setup](docs/installation.md) — Provider authentication and configuration
+- [Usage Guide](docs/usage.md) — Interactive mode and slash commands
+- [Architecture](docs/architecture.md) — System design and data flow
+- [Extensions](docs/extensions.md) — Building tools, commands, and plugins
+- [Python API](docs/python-api.md) — Programmatic usage
+
+## Core Architecture
+
+```
+Console (CLI) → TUI (Terminal UI) → Runtime (Agent Execution) → Engine (Tools) → Inference (LLM)
+```
+
+User input flows through the TUI to the runtime, which executes tools via the engine and calls the LLM provider for inference. Results are rendered back in the TUI and persisted to sessions.
+
+## Configuration
+
+Settings are loaded in order of precedence:
+1. Built-in defaults
+2. `~/.tau/settings.json` (global user settings)
+3. `.tau/settings.json` (project-level settings)
+4. Environment variables
+5. Command-line flags
+
+Sessions are saved to `~/.tau/sessions/` and can be resumed, forked, or cloned.
+
+### Project Context Files
+
+Tau automatically discovers and includes project-specific instructions from `AGENTS.md` or `CLAUDE.md` in the system prompt. This allows you to:
+- Define project rules and coding guidelines for the agent
+- Standardize how the agent handles project-specific conventions
+- Store project context separately from tool configuration
+
+**Example usage:**
+```bash
+# Auto-discover AGENTS.md in the project (default behavior)
+tau
+
+# Disable project context file loading
+tau --no-context-files
+
+# Trust project files explicitly
+tau --approve
+
+# Don't trust project files for this run
+tau --no-approve
+```
+
+See [Project Context Files](docs/project-context.md) for detailed instructions.
+
+## Security & Permissions
+
+Tau executes tools (terminal, file I/O, web operations) with the permissions of the user and process that launched it. There is no built-in permission system for restricting filesystem, process, network, or credential access.
+
+If you need stronger boundaries, consider:
+- Running Tau inside a container or sandbox
+- Using OS-level security policies
+- Configuring environment variables to limit tool access
+
+## Supply Chain Security
+
+We treat dependency changes as reviewed code changes with these practices:
+
+- **Exact version pinning** — All direct dependencies pinned to specific versions in `pyproject.toml`
+- **Lockfile integrity** — `uv.lock` is the source of truth; changes require explicit review
+- **Dependency auditing** — Use `pip-audit` or `safety` to scan for known vulnerabilities
+- **Safe installation** — Install with `--no-deps` to prevent malicious lifecycle scripts
+
+See [SECURITY.md](SECURITY.md) for detailed practices and vulnerability reporting.
+
+## Development
+
+```bash
+python -m pytest              # Run tests
+pyright tau/                   # Type checking
+python -m tau --mode tui       # Launch from source
+```
+
+See [Development Setup](docs/development.md) for detailed instructions.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines and [AGENTS.md](AGENTS.md) for project-specific rules.
+
+## License
+
+This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.

tau_coding_agent-0.1.0/README.md

@@ -0,0 +1,148 @@
+# Tau
+
+Inspired by [Pi](https://pi.dev), Tau brings the same agent framework capabilities to Python developers. A self-extensible agent CLI with a terminal UI, multi-provider LLM support, session management with branching, and a plugin system for tools, commands, and customization.
+
+---
+
+## Quick Start
+
+### Installation
+
+```bash
+pip install tau-coding-agent
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/Jeomon/Tau.git
+cd Tau
+pip install -e .
+```
+
+### Launch
+
+```bash
+tau
+```
+
+Authenticate with your LLM provider using `/login` or set environment variables (e.g., `ANTHROPIC_API_KEY`).
+
+### Common Commands
+
+```bash
+tau                                           # Interactive mode
+tau --resume                                  # Resume most recent session
+tau --model claude-sonnet-4-6                 # Use specific model
+tau --print "Summarize this repo"             # One-shot mode
+tau -p anthropic --print "Explain this code"  # Print mode with provider
+tau --mode rpc                                # RPC mode for IDE extensions
+```
+
+> For detailed options, see [CLI Reference](docs/cli-reference.md)
+
+## Features
+
+- **Multi-provider LLM support** — Anthropic Claude, OpenAI GPT, Google Gemini, Mistral AI, Ollama, Azure OpenAI
+- **Terminal UI** — Built-in chat interface with syntax highlighting, markdown rendering, and keyboard navigation
+- **Rich media support** — Work with text files, images, audio files, and video files via file references or clipboard input
+- **Session management** — Persistent sessions with branching, forking, and resuming capabilities
+- **Tool execution** — Built-in tools (terminal, file I/O, web fetch) with sandboxed execution and extensibility
+- **Plugin system** — Add custom tools, slash commands, hooks, themes, and skills without modifying core code
+- **16 built-in themes** — Dark and light themes including dracula, nord, gruvbox, catppuccin, ayu-dark, tokyo-night, rose-pine, and more
+- **Context management** — Automatic context compaction and branch summarization for long conversations
+- **Python API** — Embed Tau in your own applications programmatically
+- **Multiple run modes** — Interactive TUI, print mode (one-shot), JSON event stream, and JSON-RPC for IDE integration
+
+## Documentation
+
+Start here: [**Tau Documentation**](docs/index.md)
+
+**Key resources:**
+- [Quickstart](docs/quickstart.md) — Five-minute getting started guide
+- [Installation & Setup](docs/installation.md) — Provider authentication and configuration
+- [Usage Guide](docs/usage.md) — Interactive mode and slash commands
+- [Architecture](docs/architecture.md) — System design and data flow
+- [Extensions](docs/extensions.md) — Building tools, commands, and plugins
+- [Python API](docs/python-api.md) — Programmatic usage
+
+## Core Architecture
+
+```
+Console (CLI) → TUI (Terminal UI) → Runtime (Agent Execution) → Engine (Tools) → Inference (LLM)
+```
+
+User input flows through the TUI to the runtime, which executes tools via the engine and calls the LLM provider for inference. Results are rendered back in the TUI and persisted to sessions.
+
+## Configuration
+
+Settings are loaded in order of precedence:
+1. Built-in defaults
+2. `~/.tau/settings.json` (global user settings)
+3. `.tau/settings.json` (project-level settings)
+4. Environment variables
+5. Command-line flags
+
+Sessions are saved to `~/.tau/sessions/` and can be resumed, forked, or cloned.
+
+### Project Context Files
+
+Tau automatically discovers and includes project-specific instructions from `AGENTS.md` or `CLAUDE.md` in the system prompt. This allows you to:
+- Define project rules and coding guidelines for the agent
+- Standardize how the agent handles project-specific conventions
+- Store project context separately from tool configuration
+
+**Example usage:**
+```bash
+# Auto-discover AGENTS.md in the project (default behavior)
+tau
+
+# Disable project context file loading
+tau --no-context-files
+
+# Trust project files explicitly
+tau --approve
+
+# Don't trust project files for this run
+tau --no-approve
+```
+
+See [Project Context Files](docs/project-context.md) for detailed instructions.
+
+## Security & Permissions
+
+Tau executes tools (terminal, file I/O, web operations) with the permissions of the user and process that launched it. There is no built-in permission system for restricting filesystem, process, network, or credential access.
+
+If you need stronger boundaries, consider:
+- Running Tau inside a container or sandbox
+- Using OS-level security policies
+- Configuring environment variables to limit tool access
+
+## Supply Chain Security
+
+We treat dependency changes as reviewed code changes with these practices:
+
+- **Exact version pinning** — All direct dependencies pinned to specific versions in `pyproject.toml`
+- **Lockfile integrity** — `uv.lock` is the source of truth; changes require explicit review
+- **Dependency auditing** — Use `pip-audit` or `safety` to scan for known vulnerabilities
+- **Safe installation** — Install with `--no-deps` to prevent malicious lifecycle scripts
+
+See [SECURITY.md](SECURITY.md) for detailed practices and vulnerability reporting.
+
+## Development
+
+```bash
+python -m pytest              # Run tests
+pyright tau/                   # Type checking
+python -m tau --mode tui       # Launch from source
+```
+
+See [Development Setup](docs/development.md) for detailed instructions.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines and [AGENTS.md](AGENTS.md) for project-specific rules.
+
+## License
+
+This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.

tau_coding_agent-0.1.0/docs/IMPLEMENTATION_SUMMARY.md

@@ -0,0 +1,163 @@
+# Documentation Implementation Summary
+
+This document summarizes the documentation that has been created for the Tau project, following the style and approach from the reference project in `/Users/jeomon/Desktop/Tau/temp`.
+
+## Overview
+
+A complete documentation structure has been implemented in `./docs/` following the same patterns, structure, and writing style as the reference project.
+
+## Navigation Structure (docs.json)
+
+The documentation is organized into 5 main categories:
+
+### 1. Start Here
+- **Overview** (index.md) - Documentation entry point
+- **Quickstart** (quickstart.md) - 5-minute getting started
+- **Installation** (installation.md) - Provider setup and authentication
+- **Architecture** (architecture.md) - System design overview
+- **Usage Guide** (usage.md) - Interactive mode features
+
+### 2. Core Concepts
+- **Inference Providers** (inference-providers.md) - All supported LLM providers
+- **Messages & Context** (messages.md) - Message system and context windows
+- **Sessions** (sessions.md) - Session management and persistence
+- **Tools** (tools.md) - Available tools and tool system
+
+### 3. Customization
+- **Settings** (settings.md) - Configuration files and options
+- **Extensions** (extensions.md) - Creating custom tools and commands
+- **Themes** (themes.md) - Color themes and terminal customization
+- **Keybindings** (keybindings.md) - Keyboard shortcuts
+
+### 4. Programmatic Usage
+- **Python API** (python-api.md) - Embedding tau in applications
+- **CLI Reference** (cli-reference.md) - All command-line options
+
+### 5. Development
+- **Development Setup** (development.md) - Local development environment
+- **Project Structure** (project-structure.md) - Codebase organization
+
+## Documentation Files Created
+
+| File | Size | Purpose |
+|------|------|---------|
+| docs.json | 1.9K | Navigation structure |
+| index.md | 1.7K | Documentation overview |
+| quickstart.md | 2.1K | Get started in 5 minutes |
+| installation.md | 3.7K | Provider setup |
+| architecture.md | 6.7K | System design |
+| usage.md | 4.8K | Interactive mode guide |
+| inference-providers.md | 4.6K | Provider reference |
+| messages.md | 3.4K | Message system |
+| sessions.md | 4.0K | Session management |
+| tools.md | 4.0K | Tool reference |
+| settings.md | 4.7K | Configuration guide |
+| extensions.md | 4.8K | Extension system |
+| themes.md | 3.9K | Theme customization |
+| keybindings.md | 4.4K | Keyboard shortcuts |
+| python-api.md | 5.0K | Python API reference |
+| cli-reference.md | 4.8K | CLI options |
+| development.md | 4.1K | Development setup |
+| project-structure.md | 7.7K | Codebase organization |
+
+**Total: 18 documentation files, ~70KB of content**
+
+## Style & Format Adherence
+
+All documentation follows the reference project's style:
+
+### Structure
+- ✅ Single-sentence purpose statement on each page
+- ✅ H1 used exactly once per document
+- ✅ Logical heading hierarchy (H2, H3 only)
+- ✅ Table of Contents in docs.json (not repeated in files)
+- ✅ Cross-references using relative links `[text](file.md)`
+
+### Content
+- ✅ No emojis anywhere
+- ✅ No fluff or cheerful filler
+- ✅ Direct, technical prose
+- ✅ Practical, copy-pasteable examples
+- ✅ Tables for reference data
+- ✅ Code blocks with language identifiers
+- ✅ Real-world usage examples
+
+### Organization
+- ✅ Organized by user need (not implementation details)
+- ✅ Beginner content first, advanced content later
+- ✅ Quick reference for common tasks
+- ✅ "Start here" section for new users
+- ✅ "Next steps" cross-links at bottom
+
+## Key Features
+
+### 1. User Journey
+Documentation is organized around user needs:
+- **New users**: Quickstart → Installation → Usage
+- **Advanced users**: Python API → Extensions → Architecture
+- **Reference**: CLI Reference → Settings → Tools
+
+### 2. Consistency
+- All documents follow the same structure
+- Same terminology throughout
+- Consistent code formatting
+- Consistent table layouts
+
+### 3. Completeness
+Every major feature is documented:
+- All inference providers (Anthropic, OpenAI, Google, Mistral, Ollama, Azure)
+- All CLI options and commands
+- All settings and configuration
+- Extension system (tools, commands, hooks)
+- Session management
+- Customization (themes, keybindings)
+
+### 4. Examples
+Every major feature includes:
+- Real, copy-pasteable code examples
+- Actual use cases
+- Common workflows
+- Troubleshooting tips
+
+## Reference Document
+
+A comprehensive style reference was also created at:
+**DOCUMENTATION_REFERENCE.md**
+
+This document codifies the documentation approach for future reference and ensures consistency when adding new docs.
+
+## How to Use This Documentation
+
+### For Users
+1. Start with `docs/index.md` or `docs/quickstart.md`
+2. Use `docs.json` to navigate by category
+3. Follow "Next steps" links to deeper topics
+
+### For Developers
+1. See `docs/development.md` for setup
+2. See `docs/project-structure.md` for codebase overview
+3. See `docs/extensions.md` to add features
+
+### For Maintainers
+1. Follow `DOCUMENTATION_REFERENCE.md` when adding new docs
+2. Keep `docs.json` synchronized with filesystem
+3. Maintain cross-references when renaming files
+
+## Future Documentation
+
+When adding new documentation:
+1. Follow patterns in `DOCUMENTATION_REFERENCE.md`
+2. Update `docs.json` with new entry
+3. Add link to `index.md` if it's a top-level topic
+4. Cross-link related documents
+
+## Next Steps
+
+The documentation is ready to use. No changes needed to the code—just documentation has been added.
+
+To verify:
+```bash
+ls -la docs/
+```
+
+All 18 documentation files should be present in the `./docs/` directory.