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!