Project Nexus

Cursor IDE written entirely in Frontier Syntax — a self-hosting, AI-native development environment.

This repository bootstraps Cursor Gate (15-gate review) and hosts the Frontier Syntax source for Nexus IDE modules.

Vision

Layer	Language	Status
IDE shell (editor, workspace, terminal)	Frontier Syntax .fr	Buffer + gate bridge implemented — see nexus/
Quality gates & agent policy	Python (cursor_gate*.py)	Bootstrapped & CI-green
Frontier compiler / runtime	External — frontier-syntax	Dependency (not vendored)

Quick start

# Bootstrap gate reviewers + agent policy (also runs on cloud agent VM boot)
bash scripts/install-agent-environment.sh

# Gate a Python file (both reviewers must PASS before shipping)
bash scripts/gate-file.sh --file samples/hello_passing.py

# Gate all changed .py / .ts / .js files
bash scripts/gate-all-changed.sh

Nexus modules (nexus/)

Module	File	Purpose	Status
Bootstrap	nexus/main.fr	IDE entrypoint	Implemented
Editor	nexus/editor/buffer.fr	Text buffer & edits	Implemented
Workspace	nexus/workspace/tree.fr	File tree & project root	Minimal API
Agent	nexus/agent/session.fr	AI agent session loop	Minimal API
Shell	nexus/shell/terminal.fr	Integrated terminal	Minimal API
Gate bridge	nexus/gate/review.fr	Invoke Cursor Gate from Frontier	Implemented (scripts/gate-bridge.sh)

See docs/ROADMAP.md for the full gap audit and dependency on frontier-syntax.

Agent completion policy

Every cloud agent environment bootstraps this policy via .cursor/environment.json:

• .cursor/rules/ship-finished-work.mdc — ship finished work only
• .cursor/rules/quarterback-worker.mdc — quarterback / worker delegation
• AGENTS.md — agent instructions at repo root
• scripts/install-agent-environment.sh — installs gate scripts to ~/.cursor/

Global (all projects): paste docs/USER_RULES_PASTE.md into Cursor → Customize → Rules → User Rules.

CI

.github/workflows/gate-check.yml runs on every pull request: install deps, bootstrap agent environment, gate samples/hello_passing.py.

Configuration

Copy .env.example to ~/.cursor/.env or project .env for optional LLM-backed gate settings.

Re-bootstrap Cursor Gate from Schema

SCHEMA_ROOT=/path/to/Schema bash /path/to/Schema/scripts/bootstrap-repo.sh .