Tau is a Rust-first agent runtime and operator control plane with a connected core path: CLI runtime -> sessions/tools/safety -> gateway APIs -> transport and operator workflows.

Short answer to the integration question: the core runtime path is integrated and runnable today, while some subsystems are still staged or partial.

Tau combines:

• a primary CLI runtime (tau-coding-agent) for interactive and one-shot execution,
• persistent session and tool-policy/safety controls,
• gateway and operator surfaces for API and operations workflows,
• deterministic demos and validation scripts for local and CI loops.

The workspace is intentionally multi-crate and contract-driven. Full crate membership is in Cargo.toml.

• Operators who need repeatable runtime controls, diagnostics, and rollback-friendly workflows.
• Integrators who need OpenAI-compatible gateway routes and transport bridges.
• Contributors working in a spec-driven, TDD-oriented Rust workspace.

These are the paths that operate as connected flows today.

• Run interactive and one-shot agent flows from tau-coding-agent.
• Use session persistence and lifecycle operations (branch, resume, export/import/repair).
• Route model calls across multiple provider/auth modes.
• Run gateway API surfaces and operator routes.
• Use built-in tools with policy controls (filesystem/shell/http/path/rate/sandbox).
• Run channel and bridge runtimes (GitHub Issues, Slack, Discord, Telegram/WhatsApp paths).
• Operate prompt-optimization workflows with SQLite-backed rollout state and optional proxy attribution.
• Execute deterministic demo suites and validation scripts in local/CI loops.

Some surfaces are intentionally diagnostics-first or staged:

• True RL:
  • deterministic end-to-end harness is available (tau-trainer),
  • policy-operations depth (promotion/rollback/significance/runtime-audit) is aggregated in scripts/verify/m310-rl-policy-ops-depth.sh,
  • operations drill depth (operational safety, resume-after-crash, benchmark/safety, rollback checklist) is aggregated in scripts/verify/m316-rl-operations-drill-depth.sh,
  • broader production policy-optimization operating loops remain an expansion track.
• Dashboard:
  • route and diagnostics surfaces exist,
  • operator workflow depth across ops chat/session/lineage/memory-graph/tools routes is aggregated in scripts/verify/m314-dashboard-operator-workflow-depth.sh,
  • command-center depth (timeline/alert/control markers + control-action fail paths + live stream matrix) is aggregated in scripts/verify/m318-dashboard-command-center-depth.sh,
  • not all desired product UX workflows are fully integrated live-mutation paths.
• Auth verification:
  • provider auth-mode matrix and gateway auth/session lifecycle conformance are covered in deterministic suites (scripts/verify/m295-operator-maturity-wave.sh),
  • auth-depth lifecycle and edge-path coverage is aggregated in scripts/verify/m303-auth-workflow-depth.sh,
  • credential lifecycle depth (integration-auth set/status/rotate/revoke + resolve-secret fail-closed) is aggregated in scripts/verify/m309-auth-credential-lifecycle-depth.sh,
  • live-env validation depth (skip/enable/key contracts + aggregated auth-depth gates) is aggregated in scripts/verify/m312-auth-live-env-depth.sh,
  • live third-party credential/network validation remains environment-specific.
• Multi-channel orchestration:
  • deterministic C5 scenario-depth coverage is aggregated in scripts/verify/m307-multi-channel-orchestration-depth.sh,
  • live connector/provider uptime and credential validation remain environment-specific.
• E2E core verification:
  • deterministic integration+gateway core scenario depth is aggregated in scripts/verify/m313-e2e-core-scenario-depth.sh,
  • deterministic operator-route scenario depth is aggregated in scripts/verify/m315-e2e-operator-route-depth.sh,
  • full PRD-wide scenario-group completion continues as an expansion track.
• TUI:
  • includes operator-shell, interactive agent, and state-backed shell-live modes,
  • shell-live now reports deterministic malformed/missing artifact diagnostics for operator triage,
  • operator workflow depth (shell, shell-live watch, and artifact diagnostics) is aggregated in scripts/verify/m311-tui-operator-workflow-depth.sh,
  • scenario-expansion depth (demo mode behavior + parser/shell-live edge paths + workflow-depth chaining) is aggregated in scripts/verify/m317-tui-scenario-expansion-depth.sh,
  • remains complementary to (not a replacement for) web dashboard workflows.

Run commands from repository root.

1. Prerequisite

rustup default stable

1. Fast validation loop

./scripts/dev/fast-validate.sh

1. Initialize local Tau state

cargo run -p tau-coding-agent -- --onboard --onboard-non-interactive

1. Run your first prompt

cargo run -p tau-coding-agent -- --prompt "Summarize src/lib.rs"

1. Optional TUI operator shell

cargo run -p tau-tui -- shell --width 88 --profile local-dev --no-color

1. Optional interactive TUI agent mode from runtime artifacts

cargo run -p tau-tui -- agent \
  --dashboard-state-dir .tau/dashboard \
  --gateway-state-dir .tau/gateway \
  --request-timeout-ms 45000 \
  --agent-request-max-retries 0 \
  --width 88 \
  --profile local-dev \
  --no-color

1. Optional live TUI watch mode (read-only, multi-cycle refresh)

cargo run -p tau-tui -- shell-live --state-dir .tau/dashboard --width 88 --profile local-dev --watch --iterations 3 --interval-ms 1000 --no-color

For a deeper walkthrough, use docs/guides/quickstart.md.

Fast local compile-focused loop:

./scripts/dev/fast-validate.sh --check-only --direct-packages-only --skip-fmt

Unified one-command runtime entrypoint:

./scripts/dev/prove-tau-product.sh --check
./scripts/dev/prove-tau-product.sh --check --report /tmp/tau-product-proof-check.json
./scripts/dev/prove-tau-product.sh --run
./scripts/dev/prove-tau-product.sh --run --report /tmp/tau-product-proof-run.json
./scripts/dev/prove-tau-product.sh --run --webchat-smoke --report /tmp/tau-product-proof-webchat.json
./scripts/run/tau-unified.sh up --auth-mode localhost-dev
./scripts/run/tau-unified.sh status
./scripts/run/tau-unified.sh tui --no-color
./scripts/run/tau-unified.sh tui --request-timeout-ms 90000 --agent-request-max-retries 1 --no-color
./scripts/run/tau-unified.sh tui --live-shell --iterations 3 --interval-ms 1000 --no-color
./scripts/run/tau-unified.sh down

tau-unified.sh tui defaults to fast-fail interactive policy:

• --request-timeout-ms 45000
• --agent-request-max-retries 0

Override defaults with flags above or env vars:

• TAU_UNIFIED_TUI_REQUEST_TIMEOUT_MS
• TAU_UNIFIED_TUI_AGENT_REQUEST_MAX_RETRIES

Interactive TTY turns now emit progress markers to stderr while requests are in-flight:

• interactive.turn=start turn_timeout_ms=... request_timeout_ms=...
• interactive.turn=running elapsed_ms=...
• interactive.turn=end status=... elapsed_ms=...

Full pre-merge gate:

./scripts/dev/fast-validate.sh --full

Interactive runtime mode:

cargo run -p tau-coding-agent -- --model openai/gpt-5.2

Gateway auth/session smoke:

./scripts/demo/gateway-auth-session.sh

Dashboard demo path:

./scripts/demo/dashboard.sh

Demo index and selective runs:

./scripts/demo/index.sh --list
./scripts/demo/index.sh --only onboarding,gateway-auth,gateway-remote-access --fail-fast

./scripts/demo/all.sh --list
./scripts/demo/all.sh --only local,rpc,events --fail-fast

RL end-to-end deterministic harness:

cargo run -p tau-trainer --bin rl_e2e_harness -- --run-id local --output-dir artifacts/rl-e2e --print-json

Operator maturity wave verification (TUI + RL + auth):

./scripts/verify/m295-operator-maturity-wave.sh

TUI interactive agent loop from runtime artifacts:

cargo run -p tau-tui -- agent \
  --dashboard-state-dir .tau/dashboard \
  --gateway-state-dir .tau/gateway \
  --request-timeout-ms 45000 \
  --agent-request-max-retries 0 \
  --profile local-dev \
  --no-color

TUI live watch loop from dashboard artifacts:

cargo run -p tau-tui -- shell-live --state-dir .tau/dashboard --profile local-dev --watch --iterations 3 --interval-ms 1000 --no-color

M296 GA readiness gate (Connected operator GA loop):

./scripts/verify/m296-ga-readiness-gate.sh

Clean generated local artifacts:

./scripts/dev/clean-local-artifacts.sh

Checked-in example assets and starter package references:

• ./examples/starter/package.json
• ./examples/extensions
• ./examples/extensions/issue-assistant/extension.json
• ./examples/extensions/issue-assistant/payload.json
• ./examples/events
• ./examples/events-state.json
• ./examples/pacman-tetris
• ./examples/pacman-tetris-ws

See ./examples/README.md for package and asset walkthrough details.

Primary docs index: docs/README.md

Operator deployment guide: docs/guides/operator-deployment-guide.md Gateway API reference (70+ routes): docs/guides/gateway-api-reference.md Contributor guide: CONTRIBUTING.md Security policy: SECURITY.md

Operator runbooks:

• docs/guides/operator-deployment-guide.md
• docs/guides/operator-control-summary.md
• docs/guides/dashboard-ops.md
• docs/guides/gateway-ops.md
• docs/guides/memory-ops.md
• docs/guides/m296-ga-readiness-gate.md

Integrator/API references:

• docs/guides/gateway-api-reference.md
• docs/guides/transports.md
• docs/provider-auth/provider-auth-capability-matrix.md

Contributor references:

• CONTRIBUTING.md
• AGENTS.md
• docs/tau-coding-agent/code-map.md
• docs/architecture/crate-dependency-diagram.md
• docs/guides/startup-di-pipeline.md
• docs/guides/contract-pattern-lifecycle.md
• docs/guides/multi-channel-event-pipeline.md
• docs/guides/doc-density-scorecard.md

Planning and gap closure:

• docs/planning/true-rl-roadmap-skeleton.md
• docs/guides/roadmap-execution-index.md
• docs/planning/integration-gap-closure-plan.md

Core runtime:

• crates/tau-coding-agent
• crates/tau-agent-core
• crates/tau-runtime
• crates/tau-orchestrator

Gateway and ops:

• crates/tau-gateway
• crates/tau-dashboard
• crates/tau-dashboard-ui
• crates/tau-ops

Model and policy:

• crates/tau-ai
• crates/tau-provider
• crates/tau-tools
• crates/tau-safety

State and extension surfaces:

• crates/tau-session
• crates/tau-memory
• crates/tau-extensions
• crates/tau-skills

Transport/bridge runtimes:

• crates/tau-github-issues-runtime
• crates/tau-slack-runtime
• crates/tau-discord-runtime
• crates/tau-multi-channel

Training and algorithms:

• crates/tau-training-types
• crates/tau-training-store
• crates/tau-training-tracer
• crates/tau-training-runner
• crates/tau-training-proxy
• crates/tau-trainer
• crates/tau-algorithm

Local Docker smoke build:

./scripts/dev/docker-image-smoke.sh --tag tau-coding-agent:local-smoke

Release workflow and artifacts:

• .github/workflows/release.yml
• docs/guides/release-automation-ops.md
• GitHub Releases: https://github.com/njfio/Tau/releases

• Security reporting policy: SECURITY.md
• Contribution guide: CONTRIBUTING.md
• Issue/spec workflow contract: AGENTS.md

This repository expects issue-first, spec-driven, test-driven changes with explicit validation evidence.