Summary

Clodex is a local-first, zero-trust agentic IDE for verifiable autonomous software development. It integrates AI tasks, code, terminal, and browser within a governed Electron workspace, treating model output as untrusted input. Targeting engineers and researchers, it enhances reliability and security by enforcing authority via explicit policy, isolated runtimes, and user review.

How It Works

Clodex treats model output as untrusted input, establishing authority through explicit policy, isolated runtimes, and user review. It models engineering work as durable tasks with persistent state, workspaces, and lifecycles. The architecture enforces strict trust boundaries, separating UI, agent execution, tools, secrets, and policy. Sensitive operations bypass model runtime via deterministic controls, ensuring fail-closed security, isolated hosts, explicit capabilities, controlled egress, protected storage, and human oversight.

Quick Start & Requirements

• Install/Run: Clone repo, install Node.js (22.23.1) and pnpm (10.30.3), then run pnpm install --frozen-lockfile, pnpm build:packages, and pnpm --dir apps/browser start:fast.
• Prerequisites: Node.js 22.23.1, pnpm 10.30.3, Git. Development on macOS, Linux, Windows; macOS for DMG packaging.
• Links: Developer handbook, Full project documentation, Architecture, Security and data, ide.clodex.xyz.

Highlighted Details

• Persistent Tasks: Manages searchable task history, projects, workspaces, goals, progress, and budgets.
• Agent Runtime: Handles managed turns, cancellation, recovery, tool execution, and supervised lifecycle.
• Code Workspace: Integrates file editing, Git operations, PR review, and protected merge flows.
• Evidence-Backed Memory: Features scoped memory, append-only evidence records, retrieval, and provenance.
• Model & Execution Fabrics: Supports provider-neutral model routing and flexible execution (local, SSH, Docker, cloud).
• Guardian & Network Policy: Enforces independent authorization for sensitive capabilities and controlled network egress.
• Status: Technical Preview. Core features (workspace, task lifecycle, local/SSH execution) are available for local testing. Docker/external runner, Guardian/network egress, signed extensions are "Preview." Cloud Tasks/Session Teleport are "Labs / promotion-gated."

Maintenance & Community

• Contributors: Developed by an independent researcher.
• Community: Updates via X: @CLODEx_lab.

Licensing & Compatibility

• License: GNU Affero General Public License v3.0 (AGPL-3.0).
• Compatibility: AGPL-3.0's strong copyleft requires derivative works or network services to be open-sourced under AGPL-3.0, potentially limiting closed-source commercial integration.

Limitations & Caveats

The project is in "Technical Preview." Advanced execution lanes are feature-gated pending evidence and sign-off. Docker/external runner, Guardian/network egress, and signed extensions are "Preview." Cloud Tasks/Session Teleport are "Labs / promotion-gated." Stable cross-platform distribution requires further promotion evidence.