LOCAL AMY DEVELOPMENT

AMY STUDIO FOR VS CODE

Write ordinary .alexis files, keep graphics and assembly beside your source, compile with the same Amy toolchain, and inspect errors without leaving Visual Studio Code.

WINDOWS · LINUX · macOSCOMPILER INCLUDEDCOLECOVISION + ADAM
Amy source open in Visual Studio Code after a successful 260-byte ROM build
Syntax highlighting, project explorer, compile command, ROM and RAM status.
Normal source files

Your game remains readable `.alexis`, not code hidden inside JSON.

Project folders

Use separate source, asset, ASM and data files through `@project/...`.

Useful diagnostics

Compiler errors become clickable VS Code problems with source locations.

Reproducible compiler

Every VSIX carries a tested Amy compiler snapshot instead of depending on the website.

INSTALL IN THREE STEPS

No command line setup required.

Prefer terminal builds or automation? See the Amy compiler CLI reference.

Visual Studio Code Extensions menu with Install from VSIX selected

Where is “Install from VSIX”?

Open the Extensions view from the left activity bar. Its Views and More Actions… menu contains Install from VSIX…. Select the file downloaded from this page and reload VS Code when requested.

Install from VSIX

In VS Code, open Extensions, choose the … menu, then Install from VSIX… and select the download.

Open or create

Open a folder containing an `.alexis` file, or run Amy: Create Project from the Command Palette.

PROJECTS WITHOUT FRICTION

Code stays in code files.

MY-GAME/
├── amy.project.json
├── src/
│   └── main.alexis
├── assets/
└── asm/

The small amy.project.json file only records the entry source, target and build profile. It never replaces your Amy source. Standalone `.alexis` files also compile without a manifest.

{
  "name": "My Amy Game",
  "entry": "src/main.alexis",
  "target": "colecovision-cartridge",
  "optimization": "balanced"
}

DAILY COMMANDS

Compile and inspect from the editor.

CommandPurpose
Amy: Compile ProjectBuild with the project or configured optimization profile.
Amy: Compile Project (Optimization Off)Produce a diagnostic unoptimized build.
Amy: Compile Project (Aggressive)Request the aggressive optimization profile explicitly.
Amy: Open Generated AssemblyInspect the post-optimizer Z80 source.
Amy: Reveal Compiled ROMOpen the `.amy/build` output folder at the ROM.

STABLE BY DEFAULT

The compiler does not drift underneath a project.

Version 0.1.14 embeds the clean Amy Studio compiler used to build it, including the host-side ZX0 compressor used by compressed projects. Advanced users can point amyStudio.compilerPath at another checkout when deliberately testing experimental language changes.