Skip to main content

Marl Code, the terminal application

Marl Code is Quavern's agentic developer CLI for macOS, Linux, Windows and NetBSD; it uses your Marl subscription on the Pro plan or above, with no API key to copy.

J
Written by Jean-Baptiste COULON--CHABAGNO

Marl Code reads, edits and runs your code with you, in the terminal. It is proprietary Quavern software, distributed as a binary, with an interface in English and French.

It needs a Marl subscription on the Pro plan or above.

Installing

macOS, Linux and NetBSD:

curl -fsSL https://dl.quavern.net/MarlCode/install.sh | sh

Windows, in PowerShell:

irm https://dl.quavern.net/MarlCode/install.ps1 | iex

The installer verifies every download against the published release checksum before touching anything. Direct downloads and the checksum file are on marl.quavern.ai/code.

Signing in

marl login opens your browser; approve the request with your myQuavern account. There is no API key to copy.

If the approval comes from a network Quavern flags as higher-risk, you are asked to verify a telephone number first. An ordinary sign-in from an ordinary network is not blocked.

In scripts and CI, use marl login --with-token with an API key, then marl -p "…".

Using it

  • marl in a project directory, then describe what you need. /help lists the commands.

  • By default Marl asks before changing files or running commands.

  • @file adds a file, !cmd runs a shell command and passes its result to Marl, #note saves a project note.

  • marl init once creates the repository's .marl structure for settings, agents, commands and skills. The interactive /init is different: it writes the project guide MARL.md.

  • marl exec --json "…" runs one prompt without interaction and prints a single structured result, with stable exit codes, for scripts and CI.

  • --web auto or /web lets Marl search the web when a request needs it, on paid plans. Consulted pages are listed as numbered sources after the reply.

  • /usage shows the 5-hour and weekly credit windows and when they reset.

  • marl upgrade updates it.

Organisation policy

With an organisation service token, Marl Code applies the workspace policy set in myQuavern: allowed tools, denied commands, forced plan mode, a turn cap. A policy only narrows; it never grants.

Crash reporting is off

Marl Code reports nothing to Quavern unless you turn it on with marl telemetry on. When enabled, it sends the version, the operating system and the stack trace of a crash — never your prompts, your code or your file paths. marl telemetry off stops it.

When Marl is in maintenance

Marl Code shows the message the Quavern team published for that maintenance instead of failing silently.

If something goes wrong

Every failure carries a code of the form CODE3-0001. Write to [email protected] with that code, the version from marl version, your operating system, and what you asked for.

Quavern help reference: marl-code/en

Did this answer your question?