What's inside

VML is only one layer of the package. Day to day you work in four places: the command line (four forms), the built-in libraries (three tiers), the file manager (your workspace lives on the device) and the editor and sessions. All of them work on a phone and on a desktop.

1. Command line: one entry, four forms

The same agent, the same configuration and the same tools behind all of them — only where you watch it work changes.

FormHow to startGood for
1. The app's "Command line" page One of the five bottom tabs; type into the input box Running programs: it is both a shell and the place where VML programs run — vml run examples/c/app/tetris.c, with the output kept on the page
2. Full-screen desktop terminal (default) waycoder ANSI full-screen TUI: status bar, slots, inline confirmation prompts. A line starting with ! goes straight to the system shell (cmd on Windows) and its output returns to the chat
3. Plain command line waycoder --cli Line in, plain text out — scripts, CI, machines without a full-screen terminal. Combine with -p "…" for a one-shot task and --json for a structured result other programs can parse
4. Browser (web) mode waycoder --web A three-column web UI. Add --web-lan to use a phone as the screen and the computer as the compiler (a phone cannot run dotnet / gcc / Keil)

Desktops also have a graphical build (waycoder --gui) sharing the same sessions and configuration.

Slash commands and pass-through

In forms 2–4, a line starting with / is a built-in command (/model, /config, /session, /perm …) and ! hands the line to the system shell. The full key and command tables are in the guide.

Work that runs without you

  • --watch: watches files for AI! / AI? comments and acts on them;
  • --batch: one manifest, many repositories in parallel, each task cloned into its own copy, with a combined report at the end;
  • Sub-agents: a complex task is split into parallel pieces, each with its own scope.

2. Built-in libraries: three tiers

The standard library, the examples and the help pages ship inside the installer (about 36 MB / 4,300+ files) and are extracted into the workspace the first time a VML program runs — only then, or after a library update. There are three tiers, and the lower you go, the less you should use it in new code:

TierWhat is in itWho should use it
Shared library Three string layers (string / wstring / ustring), formatted I/O (printf / scanf and the wide variants), expression evaluation (parserexp / parserexpf), maths and floating point (math / float / softdouble / softint64), plus os / file / network / memory / device / convert Callable from every language: one implementation is shared across all 27
Drawing and UI tty_* colour text (cursor placement, clear screen, window size) · ui_* graphics (windows, primitives, touch and keys, timers, audio, saves) · ui_3d_* 3D (viewports, meshes, camera, lighting) New programs should use this tier; see the VML overview
Compatibility layer conio / crt (old character UIs), graphics (BGI) For old programs only: they compile and run unchanged, forwarding into the tier above instead of emulating video memory

These libraries are not hand-copied per language: a generator produces 28 bindings from one C implementation, so signatures cannot drift apart. The function list is available inside the editor (see completion and outline below).

3. File manager: the workspace is on the device

The "Files" tab manages your workspace: source code, examples and notes. On Android, once "All files access" is granted the workspace lives at sdcard/waycoder/workspace (it survives uninstall and reinstall); otherwise it stays in the app's private directory.

What you can do

  • New file / new folder / import; rename and delete;
  • Compress and share: create a ZIP, extract here, or "zip and share" a whole folder (send it over WeChat and the other side imports and extracts it);
  • Type-aware actions, so you do not have to guess: text opens in the editor; source files offer "VML compile / VML run"; .glb / .gltf / .obj get a 3D preview; .sql can run; .dbf can be viewed and edited; everything else opens in a system app.

Files and folders whose names start with a dot are hidden by default (.gitignore, .env and friends included) — there is a switch in Settings. The example icon folder .resource has its own exception switch.

4. Editor and sessions

Editor

  • Syntax highlighting and line numbers, picked by file extension;
  • Completion from the bundled function-signature table (not a guess): arrows to move, Enter or Space to accept;
  • Outline: classes, interfaces, enums, structs, functions and methods with their parameters and return types; tap one to jump to its line;
  • Five bottom panels: Problems (compile errors with positions), Output, Find, Outline, AI;
  • AI works on the whole file: ask questions or request changes; every edit is shown as a diff first and applied only after you confirm;
  • External keyboards are supported (arrows, Page Up/Down, Home/End, Del); on a phone a draggable blue "drop" moves the caret quickly.

Sessions and memory

  • Session history: create, switch, clear all, delete a single session;
  • Parallel slots (desktop): F1–F10 give you ten independent conversations, each with its own user and agent, so one task can keep running while you talk about something else;
  • Memory: .waycoder/memory/*.md keeps one fact per file, indexed by MEMORY.md; a new session retrieves the relevant ones automatically — project conventions and your preferences do not need to be repeated.

5. Remote: SSH terminal and file transfer

Things the phone cannot do get handed to your computer or server. Both paths share one account store (Settings → Accounts): save a host once, then connect with a single tap.

SSH terminal

  • A real terminal: cursor addressing, per-cell colour and the alternate screen are redrawn the way a terminal means them — vim and top look right, and terminal AI tools such as claude code or codex work from the phone;
  • Once connected the connection form collapses and the terminal fills the screen; the top bar keeps user@host:port and Disconnect;
  • The keys a phone keyboard lacks get their own row: ^C / ^D / Esc / Tab / arrows / paste / clear, scrollable sideways;
  • Pinch to change the font size (the reflow happens when you lift your fingers); tap the terminal to focus the input box;
  • The agent can use it too: the ssh tool takes command and account, so it can log in, run one command and bring the output back.

FTP / SFTP transfer

  • Every file and folder has a checkbox: tick and transfer, folders included (the folder structure is preserved);
  • The local side is wherever the Files tab currently is, so there is no second path to pick;
  • Dot-files and dot-folders are skipped automatically;
  • Transfers run on the task page: progress, cancel, a result at the end, and failures name the item.

6. Free vs. unlocked

CapabilityFreeFull edition
Editor, outline, completion, AI edits✅✅
Command line (all four forms), file manager✅✅
Built-in libraries, example programs✅✅
Compiling and running C and VML assembly✅✅
Compilers and optimiser for the other 25 languages🔒✅

The full edition is a one-time purchase (not a subscription). See pricing.

🧭 Next: how to use it

First run, keyboard shortcuts, where the configuration lives, getting started on a phone — all in the guide.

Read the guide

📚 Looking up a function

The bundled help pages list every function's signature and description by language and library; searchable inside the app.

Open the docs