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.
On this page
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.
| Form | How to start | Good 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 forAI!/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:
| Tier | What is in it | Who 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/.objget a 3D preview;.sqlcan run;.dbfcan 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/*.mdkeeps one fact per file, indexed byMEMORY.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 —
vimandtoplook right, and terminal AI tools such asclaude codeorcodexwork from the phone; - Once connected the connection form collapses and the terminal fills the screen; the top bar
keeps
user@host:portand 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
sshtool takescommandandaccount, 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
| Capability | Free | Full 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.
📚 Looking up a function
The bundled help pages list every function's signature and description by language and library; searchable inside the app.
Dolaima 都来码