What if we could collaborate with AI the same way we collaborate with human developers? With clear contracts, explicit reviews, and a process that guarantees human oversight?

This is the vision behind AetherScript.

AetherScript introduces a new, structured workflow for human-AI collaboration, built on a simple yet powerful philosophy: separate human intent from AI implementation.

How It Works: The Acceptance Model You Define the Intent (.as files): In standard TypeScript files (.as), you write the high-level architecture, interfaces, and method signatures. You define the "what." For the parts you want to delegate, you leave a simple placeholder.

// You write this in user.service.as export class UserService { public async create(data: UserCreateInput): Promise<User> { // AI, please implement the user creation logic. return "${this.create(data)}"; } }

AI Fills the Implementation (.asc files): The AetherScript engine generates the corresponding implementation in a separate, companion file (.asc). This file acts as a sandboxed staging area for the AI's work. It's the "how."

You Review and Accept (aesc merge): The AI's code never touches your main source until you explicitly approve it. You can review the implementation in a clean, focused diff view. When you're satisfied, a single command, aesc merge, seamlessly integrates the code, replacing the placeholder. It's like a pull request from your AI partner.

Why AetherScript? Full Control & Trust: No more unpredictable code magically appearing in your files. You are always the final gatekeeper.

Clean Git History: Merges are atomic and meaningful, showing a clear transition from an intent to a completed implementation.

Deep Toolchain Integration: Designed from the ground up with a compiler, a Bun runtime plugin for a seamless dev experience, and a powerful VS Code extension in mind.

A Structured Philosophy: AetherScript isn't just a tool; it's a complete methodology for making AI a true, reliable partner in professional software engineering.

We believe this is the future of AI-assisted development—structured, predictable, and always developer-led.

Intrigued? We've laid out the entire vision and technical architecture in our design document.

Dive deeper and join the conversation on GitHub: https://github.com/Pabears/AetherScript/tree/main We welcome your feedback, ideas, and contributions!