Codexia

A local, privacy‑first AI coding agent that behaves like a real engineer — predictable, project‑aware, and fully under your control.

Codexia runs entirely on your machine, understands your project structure, and edits files safely using explicit, diff‑first operations. No cloud calls. No hidden rewrites. No surprises.

---

✨ Features

• Local‑first
  All inference and file operations happen on your machine.

• Strict path fidelity
  Codexia uses the exact file paths you provide — no interpretation, no rewriting.

• Safe editing workflow

  • Shows diffs before applying changes
  • Asks for confirmation on destructive edits
  • Never deletes files without explicit approval
  • Avoids malformed JSON and hydration‑breaking output

• Project‑aware intelligence
  Remembers the file you’re working on, stays within your workspace root, and keeps context tight.

• Markdown‑safe output
  Responses avoid common pitfalls in Next.js, React, and other frameworks.

• Identity‑driven behaviour
  Codexia follows a defined system prompt that shapes its tone, safety rules, and engineering style.

---

🚀 Getting Started

1. Clone the repository

git clone <your-repo-url>
cd codexia

2. Install dependencies

npm install

3. Start the development server

npm run dev

4. Open Codexia

http://localhost:3000

---

🧠 Architecture Overview

Codexia is built on:

• Next.js — UI and local API routes
• Custom system prompt — defines identity, safety rules, and editing behaviour
• Local tool‑calling layer — handles file diffs, edits, and project navigation
• Workspace root — your chosen directory (e.g., /Users/<you>/Projects)

Codexia interacts with your files through controlled, explicit operations.
It never performs hidden actions.

---

📁 Example Project Structure

codexia/
  ├── app/
  │   ├── api/
  │   │   └── generate/
  │   │       └── route.ts
  │   └── page.tsx
  ├── components/
  ├── lib/
  ├── public/
  ├── package.json
  └── README.md

---

🔧 Scripts

npm run dev      # Start development server
npm run build    # Build for production
npm start        # Run production build

---

🛡️ Privacy

Codexia is fully local:

• No external API calls
• No telemetry
• No cloud inference
• Your code never leaves your machine

---

🧩 Customization

Codexia’s behaviour is controlled by its system prompt. You can customize:

• personality (pragmatic, warm, hybrid)
• editing rules
• tool‑calling logic
• project navigation
• safety constraints
• output formatting style

This lets you evolve Codexia into the exact coding partner you want.

---

📣 Roadmap

• Local image generation
• Multi‑project memory
• Workspace visualizer
• Plugin system
• Offline model switching
• Custom tool registry

---

❤️ Built for builders

Codexia is designed for developers who want:

• privacy
• control
• predictable behaviour
• safe file editing
• and an AI agent that feels like a real collaborator

Running the unified Codexia application

Requirements:

• Node.js 22 or newer
• Git available on PATH
• A local repository for Codexia to open
• Ollama only when using Codier planning/execution features

cp .env.example .env.local

Set WORKSPACE_DIR in .env.local to the absolute path of the repository you want Codexia to open. Keep NEXT_PUBLIC_CODEXIA_WORKSPACE_GATEWAY=codexia for the real application.

npm ci
npm run dev

Open http://localhost:3000. The Control Centre is the default mode. Choose Open IDE or Continue Workspace to enter the real workspace editor without creating a second session.

For a production run:

npm run lint
npm exec tsc -- --noEmit
npm run build
npm start

The hosted Sites implementation must set NEXT_PUBLIC_CODEXIA_WORKSPACE_GATEWAY=hosted; it retains fixture-backed, browser-safe behavior and cannot access local files or processes.