Home Docs Blog Product Contact

Omni-Agent

The Omni-Agent is the core autonomous engine inside OmniIDE. It is a goal-oriented AI system that writes, runs, debugs, and fixes code without requiring human intervention at every step.

How It Works

The Omni-Agent operates on a simple but powerful loop:

  1. Understand — Parse the user's natural language instruction and decompose it into actionable development tasks
  2. Plan — Generate a step-by-step execution plan for code generation, file creation, and command execution
  3. Execute — Write code, create files, and run terminal commands inside the Hardened Sandbox
  4. Verify — Check the output for errors or unexpected behavior
  5. Heal — If errors are detected, analyze root cause, generate fixes, and re-execute (the Self-Healing Loop)

LLM Backend

The agent supports two AI backends:

  • Google Gemini API — State-of-the-art cloud reasoning for complex tasks
  • Ollama — Local model execution for offline, privacy-first development

Capabilities

CapabilityDescription
Code GenerationWrites complete files, functions, and modules from natural language
File ManagementCreates, reads, modifies, and deletes files across the workspace
Terminal ExecutionRuns shell commands, installs dependencies, starts servers
Error RecoveryCatches terminal errors and generates corrective code automatically
Multi-File EditingHandles refactors that span multiple files simultaneously
Context AwarenessUnderstands your codebase structure, dependencies, and coding patterns

Agent Invocation

Invoke the agent through the Omni-Agent panel with natural language:

// Example instructions:
"Create a REST API with authentication using JWT"
"Refactor the database module to use connection pooling"
"Fix the failing test in user.test.js and re-run the test suite"
"Add error handling to all API endpoints"
Autonomy levels: The agent operates fully autonomously by default. You can configure omni.agent.confirmBeforeExecute to require approval before running terminal commands.

Related Concepts