AetherScript: AI-Assisted Development That You Can Trust

AetherScript: AI-Assisted Development That You Can Trust Tired of the "magic" and unpredictability of AI code generation? Do you love the power of LLMs but hate the messy diffs, the loss of control, and the "hallucinated" code that pollutes your pristine codebase?

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!