Version: v1.2.3 | Status: Active | Last Updated: March 2026
The IDE module provides client interfaces for controlling and automating integrated development environments. It supports multiple IDE backends (Cursor, Antigravity) with a unified abstract interface for file operations, command execution, and editor state management.
from codomyrmex.ide import IDEClient, IDEStatus, IDECommand, IDECommandResult
# Abstract IDE client with implementations for different editors
class MyIDEClient(IDEClient):
def execute(self, command: IDECommand) -> IDECommandResult:
...from codomyrmex.ide.cursor import CursorClient
client = CursorClient()
# Open files, navigate to symbols, execute editor commands
# Integrate with Cursor's AI featuresfrom codomyrmex.ide import IDEStatus, IDECommand, IDECommandResult, FileInfo
# IDEStatus: CONNECTED, DISCONNECTED, BUSY
# IDECommand: structured editor command
# FileInfo: file metadata for editor context| Export | Type | Purpose |
|---|---|---|
IDEClient |
Abstract Class | Unified IDE interface |
CursorClient |
Class | Cursor IDE implementation |
IDEStatus |
Enum | IDE connection state |
IDECommand |
Dataclass | Structured editor command |
IDECommandResult |
Dataclass | Command execution result |
FileInfo |
Dataclass | File metadata for editors |
| Phase | IDE Contribution |
|---|---|
| OBSERVE | Read editor state (open files, cursor position, active document) |
| BUILD | Open and edit files through IDE interface |
| EXECUTE | Execute editor commands, apply code changes |
| VERIFY | Check IDE diagnostics and linting results |
Interface Layer — Top-level user interaction module. Consumes coding/ (code operations) and git_operations/ (VCS integration). No MCP tools — operates through direct IDE protocol.
- Self: PAI.md
- Parent: ../PAI.md — Source-level PAI module map
- Root Bridge: ../../../PAI.md — Authoritative PAI system bridge doc
- Siblings: README.md | AGENTS.md | SPEC.md | API_SPECIFICATION.md