Skip to content

v1.2.0

Choose a tag to compare

@al2m4n al2m4n released this 19 Oct 00:09
ba741e7

TheYgent 1.2 brings an MCP server for coding agents. Add it to Claude Code, Codex, OpenCode or any MCP client, and the coding agent gets TheYgent as tools. It can offload work to your local models, run and build agents, and search your docs and code.

The MCP server (#87)

  • Offload to a local model. ask_model sends a prompt to a model on your inference plane and returns its answer.

    • files attaches local files. The MCP server reads them itself and sends them only to the model, so a long log never enters the coding agent's context; only the answer comes back.
    • think: false turns a reasoning model's thinking off. On a commit-title prompt that meant 16 generated tokens instead of 417.
  • Run your agents. list_agents, run_agent and get_run run any published agent by id or name, on your own models and tools. Every run is traced on the Runs page.

  • Build agents.

    • agent_authoring_guide is generated from the runtime's own node registry.
    • validate_agent applies the publishing rules locally, and run_graph test-runs a document without saving it.
    • create_agent and publish_agent_version publish it.
    • list_samples and install_samples install the sample agents.

    What the coding agent builds is an ordinary agent that opens in the editor.

  • Search your docs and code.

    • create_rag_source creates a retrieval source.
    • add_rag_files takes files, folders, or globs such as docs/**/*.md. It skips hidden, dependency and build directories, and names each document by its path in the project.
    • search_rag uses the same hybrid retrieval as agents.

    In a live run, 21 files were indexed and searchable in about nine seconds.

  • Your machine, your key. The server runs beside the coding tool, over stdio or streamable HTTP, and holds no state. Model calls go straight to the inference plane. Everything else goes to the control plane with a personal API key (THEYGENT_API_KEY), which acts with your role.

  • Setup in one command. make mcp-setup prints the configuration for Claude Code, Codex and OpenCode, with your checkout's path filled in.

Start with Use TheYgent from coding agents and Tools & recipes, or read the overview and the blog post.

Also in this release

  • Retrieval indexes source code (#87). Uploads accept source code and config files: Python, TypeScript/JavaScript, Go, Rust, Java, Swift, C/C++, shell, SQL, YAML, TOML and more. They index as plain text, from the RAG page and from add_rag_files.
  • MLX prompt-cache size (#86). A new MLX launch setting, promptCacheSize, sets how many prompt states the engine keeps for reuse. The default is 10. Raise it when one model serves several agents or concurrent runs. The LLM node docs now explain why a fixed seed costs prompt reuse on MLX's hybrid models.
  • New environment variables for the MCP server: THEYGENT_API_KEY, THEYGENT_MCP_DEFAULT_MODEL and THEYGENT_MCP_RUN_TIMEOUT_S. It also reads THEYGENT_CONTROL_PLANE_URL and THEYGENT_INFERENCE_PLANE_URL.
  • Website. A new coding-agents page, a blog post, and the home page announcement.

Upgrading

No database migrations and no changes to agents or the IR. Nothing to install: the coding tool starts the MCP server with uv run, which syncs the new theygent-mcp package on first use. Follow the setup guide.

Known limits

  • No durable runs from the MCP tools. run_agent and run_graph start ordinary runs. Agents with durable-only nodes (human approval, subgraph, loop, map) still run from the interface or the API.
  • Timeouts. Long agent runs need the coding tool's tool timeout raised. Codex stops a tool call after 60 seconds by default; the setup guide shows where to raise it for each tool.
  • Verified clients. Claude Code was verified end to end, with tools called by the model. OpenCode's printed configuration connects (opencode mcp list). Codex was checked against its documented configuration only.

Full changelog: v1.1.0...v1.2.0