Personal Codex

Personal Codex is a local-first coding assistant with a ChatGPT-style interface.

Phase 2 Status

• Backend: FastAPI, SQLite, SQLAlchemy 2, Alembic, Ollama local HTTP client
• Frontend: Angular 18+ standalone app scaffold
• Streaming chat and conversation persistence implemented

Phase 3 Status

• Workspace registration and secure root path canonicalization
• Repository browsing with file listing and content preview
• Read-only local workspace search with ripgrep integration
• Git status and diff support for registered repositories

Agent Runtime

• Native Ollama tool loop with compatibility handling for Qwen 2.5 Coder tool JSON
• Automatic, grounded whole-project analysis across backend, frontend, and VS Code extension manifests and entry points
• Read-only workspace tools run automatically; file writes and terminal commands remain approval-gated in VS Code
• Copilot-style Ask/Agent modes, live tool activity, conversation history, and actionable change proposals

Setup

1. Create and activate a Python environment:

   python -m venv .venv
   .\.venv\Scripts\Activate.ps1

2. Install backend dependencies:

   python -m pip install -r requirements.txt

3. Install frontend dependencies:

   cd frontend
   npm install

4. Run the backend:

   uvicorn main:app --reload

5. Run the frontend:

   cd frontend
   npm start

Notes

• Ollama must be running locally and accessible at http://127.0.0.1:11434.
• The default model is qwen2.5-coder:7b.
• API Base URL: http://127.0.0.1:8000/api.