@trace META-001: Task Decomposition @trace META-002: Agent Selection @trace META-003: Plan Execution @trace META-004: Context Management @trace META-005: Reflection @trace META-007: Multi-Agent Coordination

Phenotype dotfiles manager, platform bootstrap tool, and polyglot development hub.

thegent is the single entry point for bootstrapping developer machines, managing AI agent workflows, orchestrating multi-agent swarms, and enforcing governance across the Phenotype ecosystem. It combines a Python CLI with Rust performance extensions and ships project templates for 10+ language stacks.

• Architecture
• Key Features
• Quick Start
• Directory Structure
• Rust Crates
• CLI Commands
• Dotfiles and System Bootstrap
• Templates
• Performance
• Development
• License

graph TB
    subgraph User
        CLI[thegent CLI<br/>Python + Typer]
        SHIMS[Shim Wrappers<br/>clode / dex / roid / droid]
    end

    subgraph Core["Core (Python)"]
        ORCH[Agent Orchestrator]
        GOV[Governance & Policy]
        ROUTER[Provider Router<br/>Claude / Gemini / OpenAI]
        MCP[MCP Server]
        SYNC[Workstream Autosync<br/>GitHub Projects + Linear]
    end

    subgraph Rust["Rust Crates (crates/)"]
        PARSER[thegent-parser]
        DISCOVERY[thegent-discovery]
        GIT[thegent-git]
        CACHE[thegent-cache]
        CRYPTO[thegent-crypto]
        FS[thegent-fs]
        HOOKS[thegent-hooks]
        TUI[thegent-tui]
        METRICS[thegent-metrics]
        MEMORY[thegent-memory]
    end

    subgraph Assets["Dotfiles & Templates"]
        DOTFILES[dotfiles/<br/>shell, git, claude, tools]
        TEMPLATES[templates/<br/>python, ts, rust, go, ...]
        SHELL[shell/<br/>zsh integration, starship]
    end

    CLI --> ORCH
    CLI --> GOV
    SHIMS --> CLI
    ORCH --> ROUTER
    ORCH --> MCP
    ORCH --> SYNC
    CLI --> DISCOVERY
    CLI --> PARSER
    ORCH --> GIT
    ORCH --> CACHE
    GOV --> CRYPTO
    CLI --> FS
    CLI --> HOOKS
    CLI --> TUI
    ORCH --> METRICS
    ORCH --> MEMORY
    CLI --> DOTFILES
    CLI --> TEMPLATES
    CLI --> SHELL

• Platform Bootstrap -- Set up any macOS, Linux, or WSL system with a single command. Shell configs, git settings, tool installations, and project scaffolding.
• Agent Orchestration -- Run, monitor, and govern AI agents with built-in cost caps, quality gates, and audit trails.
• Multi-Provider Routing -- Route across Claude, Gemini, OpenAI, and custom proxies with automatic failover.
• Rust Performance Layer -- Tool detection in <1ms, PATH resolution in <0.5ms, 10-100x over shell baselines.
• MCP Native -- Full Model Context Protocol support for servers and resources.
• Project Templates -- Scaffolding for Python, TypeScript, Rust, Go, Ruby, Java, C++, PHP, Bash, and Zig projects with linters, formatters, and CI pre-configured.
• Governance & Policy -- Centralized policy enforcement, HITL gates, cost control, and release supply chain controls.
• Workstream Sync -- Bidirectional sync between WORK_STREAM.md, GitHub Projects, and Linear.

# Clone and install
git clone https://github.com/KooshaPari/thegent
cd thegent
uv sync --all-extras

# Bootstrap your system
thegent install -t all --scope both --full
thegent doctor

# Run your first agent
thegent run free "Analyze the current directory structure"

For Windows:

irm https://raw.githubusercontent.com/KooshaPari/thegent/main/scripts/install.ps1 | iex

All crates live under crates/ in a Cargo workspace. They use gix (gitoxide) for pure-Rust git operations.

thegent serves as the central dotfiles manager for the Phenotype ecosystem. The dotfiles/ directory contains:

• Shell -- Zsh configs, profile templates, starship prompt configuration
• Git -- Global git config, ignore patterns, hook templates
• Claude -- Claude Code configuration and agent instructions
• Tools -- Tool installation manifests and verification scripts

Bootstrap a fresh system:

# Install thegent
curl -fsSL https://raw.githubusercontent.com/KooshaPari/thegent/main/scripts/bootstrap.sh | sh -s -- install

# Full system bootstrap (shell, git, tools, project templates)
thegent install -t all --scope both --full

# Verify everything
thegent doctor

Worktree governance is built in:

thegent worktree new <domain> <scale> <change-anchor> [start-point]
thegent worktree list
thegent worktree check

thegent ships project scaffolding templates for:

Use thegent scaffold greenfield ./project --profile <name> to generate a new project from any template.

• Python 3.13+
• Rust (stable)
• uv for Python dependency management
• Task for running development commands

# Install Python deps
uv sync --all-extras

# Run quality checks
task quality        # tach + vale + ruff
task quality:full   # + ruff format --check

# Run tests
uv run pytest tests/

# Build Rust crates
cd crates && cargo build --workspace
cargo test --workspace
cargo clippy --workspace -- -D warnings

Distributed under the MIT License. See LICENSE for details.