{"id":51312361,"url":"https://github.com/jeomon/tau","last_synced_at":"2026-07-01T05:01:07.033Z","repository":{"id":365995079,"uuid":"1274651915","full_name":"Jeomon/Tau","owner":"Jeomon","description":"Tau: self-extensible agent CLI with terminal UI, multi-provider LLM support, session management, and a plugin system. Python implementation of pi","archived":false,"fork":false,"pushed_at":"2026-06-27T13:00:05.000Z","size":1702,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-27T13:06:57.945Z","etag":null,"topics":["agent","cli","llm","multi-provider","python"],"latest_commit_sha":null,"homepage":"https://github.com/Jeomon/Tau","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Jeomon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-06-19T18:38:06.000Z","updated_at":"2026-06-27T13:00:10.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Jeomon/Tau","commit_stats":null,"previous_names":["jeomon/tau"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Jeomon/Tau","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jeomon%2FTau","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jeomon%2FTau/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jeomon%2FTau/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jeomon%2FTau/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jeomon","download_url":"https://codeload.github.com/Jeomon/Tau/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jeomon%2FTau/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34993438,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-01T02:00:05.325Z","response_time":130,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","cli","llm","multi-provider","python"],"created_at":"2026-07-01T05:00:59.558Z","updated_at":"2026-07-01T05:01:07.019Z","avatar_url":"https://github.com/Jeomon.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Tau (τ)\n\nInspired 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.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/tui.jpeg\" alt=\"Tau TUI\" width=\"700\"\u003e\n\u003c/p\u003e\n\nStart a conversation with the agent in the terminal.\n\n---\n\n## Quick Start\n\n### Installation\n\n```bash\nuv pip install tau-coding-agent\n```\n\nOr install from source:\n\n```bash\ngit clone https://github.com/Jeomon/Tau.git\ncd Tau\npip install -e .\n```\n\n### Launch\n\n```bash\ntau\n```\n\nAuthenticate with your LLM provider using `/login` or set environment variables (e.g., `NVIDIA_API_KEY`).\n\n### Common Commands\n\n```bash\ntau                                           # Interactive mode\ntau --resume                                  # Resume most recent session\ntau --model claude-sonnet-4-6                 # Use specific model\ntau --print \"Summarize this repo\"             # One-shot mode\ntau -p anthropic --print \"Explain this code\"  # Print mode with provider\ntau --mode rpc                                # RPC mode for IDE extensions\n```\n\n\u003e For detailed options, see [CLI Reference](docs/cli-reference.md)\n\n## Features\n\n- **Multi-provider LLM support** — Anthropic Claude, OpenAI GPT, Google Gemini, Mistral AI, Ollama, Azure OpenAI\n- **Terminal UI** — Built-in chat interface with syntax highlighting, markdown rendering, and keyboard navigation\n- **Rich media support** — Work with text files, images, audio files, and video files via file references or clipboard input\n- **Session management** — Persistent sessions with branching, forking, and resuming capabilities\n- **Tool execution** — Built-in tools (terminal, file I/O, web fetch) with sandboxed execution and extensibility\n- **Plugin system** — Add custom tools, slash commands, hooks, themes, and skills without modifying core code\n- **16 built-in themes** — Dark and light themes including dracula, nord, gruvbox, catppuccin, ayu-dark, tokyo-night, rose-pine, and more\n- **Context management** — Automatic context compaction and branch summarization for long conversations\n- **Python API** — Embed Tau in your own applications programmatically\n- **Multiple run modes** — Interactive TUI, print mode (one-shot), JSON event stream, and JSON-RPC for IDE integration\n\n## Documentation\n\nStart here: [**Tau Documentation**](docs/index.md)\n\n**Key resources:**\n- [Quickstart](docs/quickstart.md) — Five-minute getting started guide\n- [Installation \u0026 Setup](docs/installation.md) — Provider authentication and configuration\n- [Usage Guide](docs/usage.md) — Interactive mode and slash commands\n- [Architecture](docs/architecture.md) — System design and data flow\n- [Extensions](docs/extensions.md) — Building tools, commands, and plugins\n- [Python API](docs/python-api.md) — Programmatic usage\n\n## Core Architecture\n\n```\nConsole (CLI) → TUI (Terminal UI) → Runtime (Agent Execution) → Engine (Tools) → Inference (LLM)\n```\n\nUser 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.\n\n## Configuration\n\nSettings are loaded in order of precedence:\n1. Built-in defaults\n2. `~/.tau/settings.json` (global user settings)\n3. `.tau/settings.json` (project-level settings)\n4. Environment variables\n5. Command-line flags\n\nSessions are saved to `~/.tau/sessions/` and can be resumed, forked, or cloned.\n\n### Project Context Files\n\nTau automatically discovers and includes project-specific instructions from `AGENTS.md` or `CLAUDE.md` in the system prompt. This allows you to:\n- Define project rules and coding guidelines for the agent\n- Standardize how the agent handles project-specific conventions\n- Store project context separately from tool configuration\n\n**Example usage:**\n```bash\n# Auto-discover AGENTS.md in the project (default behavior)\ntau\n\n# Disable project context file loading\ntau --no-context-files\n\n# Trust project files explicitly\ntau --approve\n\n# Don't trust project files for this run\ntau --no-approve\n```\n\nSee [Project Context Files](docs/project-context.md) for detailed instructions.\n\n## Security \u0026 Permissions\n\nTau 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.\n\nIf you need stronger boundaries, consider:\n- Running Tau inside a container or sandbox\n- Using OS-level security policies\n- Configuring environment variables to limit tool access\n\n## Supply Chain Security\n\nWe treat dependency changes as reviewed code changes with these practices:\n\n- **Exact version pinning** — All direct dependencies pinned to specific versions in `pyproject.toml`\n- **Lockfile integrity** — `uv.lock` is the source of truth; changes require explicit review\n- **Dependency auditing** — Use `pip-audit` or `safety` to scan for known vulnerabilities\n- **Safe installation** — Install with `--no-deps` to prevent malicious lifecycle scripts\n\nSee [SECURITY.md](SECURITY.md) for detailed practices and vulnerability reporting.\n\n## Development\n\n```bash\npython -m pytest              # Run tests\npyright tau/                   # Type checking\npython -m tau --mode tui       # Launch from source\n```\n\nSee [Development Setup](docs/development.md) for detailed instructions.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines and [AGENTS.md](AGENTS.md) for project-specific rules.\n\n## License\n\nThis project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeomon%2Ftau","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjeomon%2Ftau","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeomon%2Ftau/lists"}