Skip to content

Cuga Agent

CUGA is an open-source generalist agent harness for the enterprise, supporting complex task execution on web and APIs, OpenAPI/MCP integrations, composable architecture,…

Install

$npx skills add https://github.com/anthropics/skills --skill pptx -a universal
Claude Code
claude mcp add cuga-agent -- npx skills add https://github.com/anthropics/skills --skill pptx -a universal
Cursor / Claude Desktop (mcp.json)
{
  "mcpServers": {
    "cuga-agent": {
      "command": "npx",
      "args": [
        "skills",
        "add",
        "https://github.com/anthropics/skills",
        "--skill",
        "pptx",
        "-a",
        "universal"
      ]
    }
  }
}

Install command taken from the project's README or registry entry. Always review code before running it.

CUGA: Configurable Generalist Agent — Agent Harness for the Enterprise

Start with a generalist. Customize for your domain. Deploy faster!

Building a domain-specific enterprise agent from scratch is complex and requires significant effort: agent and tool orchestration, planning logic, safety and alignment policies, evaluation for performance/cost tradeoffs and ongoing improvements. CUGA is a state-of-the-art generalist agent designed with enterprise needs in mind, so you can focus on configuring your domain tools, policies and workflow.



Why CUGA? — A generalist agent harness for the enterprise: wire your APIs and MCP servers, tune reasoning and task modes, and govern behavior with policies—without rebuilding orchestration from scratch.

Feature How
MCP, OpenAPI & LangChain tools mcp_servers.yaml · CugaAgent(tools=[...])
Code generation profiles (fast / balanced / accurate) [features] cuga_mode in settings.toml · configurations/modes/
Hybrid API + browser tasks [advanced_features] mode = 'hybrid' · Playwright + browser extension
Multi-agent (CugaSupervisor) cuga start demo_supervisor · [supervisor] in settings.toml
Event-driven agents (channels · triggers · standing flows) cuga start demo + python -m cuga.backend.events.service — web chat, Slack/Discord/Telegram, webhooks, cron/poll/push flows armed from natural language with a human confirming each one, one supervisor agent over a YAML roster. Runs as a second service beside CUGA (:7860 + :8100); CUGA is unchanged when it is not deployed. Setup and the per-connector guides live in the events documentation repository.
A2A & remote agents External agent entries in supervisor config · CugaSupervisor
Policies & HITL Policies SDK — Intent Guard, Playbook, Tool Approval, Tool Guide, Output Formatter
Manage & publish cuga start manager · draft tools, MCP, LLM, and policies in the web UI, then publish a versioned config for production chat (details)
Reflection [advanced_features] reflection_enabled in settings.toml
Tool-call budgets [advanced_features] max_tool_calls_per_block / _per_run / _per_thread in settings.toml
Langflow Low-code visual workflows — integrates with CUGA (langflow.org)
Knowledge (RAG) enable_knowledge=True (default) · ingest PDFs/Office/HTML/Markdown via Docling · agent-level + session-level scopes · cuga start demo_knowledge · details
Agent skills SKILL.md under .cuga/skills (default) · cuga start demo_skills (sandbox_mode = "native" by default, or opensandbox) · or demo --sandbox with [skills] on · Agent skills
Self-host on a cluster Helm chart and deploy scripts in deployment/ · Kubernetes guide (local kind/minikube, or registry push for cloud clusters)

[SDK](https://docs.cuga.dev/docs/sdk/c

Similar plugs

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Java 面试 & 后端通用面试指南,覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io