What is Yukkai?
Yukkai is the first intelligent macOS OS Agent — an autonomous agent that controls your Mac, browses the web, orchestrates sub-agents, and solves complex problems.
Yukkai is the first intelligent macOS OS Agent. Unlike a chatbot that only generates text, Yukkai is an autonomous agent that can control a Mac, browse the web, orchestrate dozens of sub-agents in parallel, generate media, write code, and proactively solve complex problems.
The OS Agent Concept
An OS Agent is an AI that operates at the operating system level. It doesn't just respond to messages — it acts on your computer:
- Controls the desktop — takes screenshots, reads the accessibility tree, clicks, types, and navigates any application via macOS Accessibility APIs and ScreenCaptureKit.
- Browses the web — a built-in AI browser based on WebKit (the native macOS web engine) with 42 actions to navigate, scrape, and interact with any website.
- Runs terminal commands — executes bash commands directly on your Mac.
- Reads and writes files — full filesystem access with security guards.
- Orchestrates sub-agents — launches dozens of parallel AI agents for complex, decomposable tasks.
- Generates media — images, music, and video from text prompts.
- Remembers — maintains a vector knowledge base (RAG) and human memory of your preferences and patterns.
Core Capabilities
| Capability | Description |
|---|---|
| 39 Native Tools | Filesystem, bash, desktop automation, image/music/video generation, YouTube, RAG, vault, Telegram, MCP, multi-agent swarm, skills, tasks, scheduling, and more. |
| YukkaiBrowser | Built-in AI web browser (native WebKit) with stealth mode, cookie sessions, simulated human behavior, and request interception. |
| YukkaiPilot | Full Mac desktop control via Accessibility + ScreenCaptureKit — observe, click, and type in any application. |
| Swarm | Orchestration of dozens of sub-agents in parallel with freely-named roles and ~29 default profiles. |
| Workflows | Declarative, file-defined multi-stage pipelines for reusable automations. |
| YukkaiConnect | Integrations with GitHub, Slack, Notion, Trello, Linear, Asana, Gmail, and Google Drive. |
| Skills | On-demand expertise domains — Office documents, code review, testing, design, and more. |
| Security | SecurityGateway (anti-injection), AES-256-GCM Vault encryption, PathGuard (file protection). |
How It Works
Yukkai is powered by a ConversationEngine that manages the full cycle:
- You send a message.
- The ConversationEngine builds a payload (system prompt + history + message).
- The request is sent to an LLM via OpenRouter (Claude, GPT, Gemini, etc.) or through Yukkai's own model routing (Fusion, Frontier, Free).
- The LLM responds with text and/or tool calls.
- The ToolRegistry executes each tool call — after security verification (PathGuard, SecretDetector, InjectionDetector).
- Results are sent back to the LLM for continuation.
- The loop continues until a final response is produced.
Personality
Yukkai has a defined personality:
- Professional — direct, precise, actionable responses.
- Concise — no unnecessary verbosity or excessive pleasantries.
- Proactive — proposes solutions and anticipates needs.
- Expert — programming (Swift, Python, PHP, JS), systems, DevOps, data, design.
- Autonomous — when a task is clear, acts without asking for superfluous confirmation.
- Resourceful — if a solution doesn't work, finds another way around the problem.
What Yukkai Is Not
- ❌ Not a chatbot — it doesn't just generate text; it takes real actions on your Mac.
- ❌ Not a copilot plugin — it's a standalone native macOS app with full system access.
- ❌ Not a cloud service — it runs locally on your Mac with on-device processing for sensitive operations (encryption, speech recognition, desktop automation).
Getting Started
Ready to dive in? Check out:
- How is Yukkai Different? — comparison with chatbots, copilots, and other AI assistants.
- Platforms & Requirements — system requirements and supported platforms.
- First Steps — what to do after installing Yukkai.