Mamoun Code

An AI coding agent in your terminal. It reads your project, edits files, and runs commands with your approval.

Mamoun Code is in a private beta. You need a Mamoun account that is on the beta list.

Install

You need Node.js 18 or newer.

npm i -g @mamoun-code/cli

This installs the mamoun command and the binary for your system: macOS, Linux or Windows, on x64 or arm64.

Log in

mamoun login

Mamoun shows a link and a code. Open the link, check that the code matches, and approve. The terminal then says Logged in.

Your first task

In a project folder, run mamoun and type what you want:

mamoun
> Why does the cart test fail? Fix it.

Mamoun shows each file edit and command before it happens and waits for your approval.

For one task without the interactive screen:

mamoun -p "Explain what src/cart.js does"
mamoun -p "Fix the failing test in test/cart.test.js" --allow-edits

In this mode, Mamoun edits files only when you pass --allow-edits. It runs only the commands you allow:

• with an always-allow rule saved in the interactive screen;
• with --allow-command "npm test" for this run only.

Effort

--effort low|medium|high, or /effort in the interactive screen, sets how hard Mamoun works on a task. The default is medium.

• Low is quick and cheap, for small questions.
• High reads more and thinks longer, for hard bugs.

Higher effort uses more of your plan's allowance. /usage shows how much you have used.

Useful commands

| You type | What it does | |---|---| | @path/to/file | Attach a file or folder to your message | | !npm test | Run a command yourself; Mamoun sees its output | | /undo | Undo Mamoun's latest file edit | | /compact | Summarize the conversation so far, to keep long sessions fast | | /resume | Continue an earlier session in this project (or start with mamoun --resume) | | /usage | Show how much of your allowance you have used | | /help | List every command |

mamoun --continue reopens the latest session in this project.

What is stored where

• On the Mamoun server: only usage numbers, such as how many steps ran, at which effort, and what they cost. Never your files, prompts, answers or command output.
• On your machine: your conversations, in ~/.mamoun. Old sessions are cleaned up automatically.
• Mamoun never reads files your .gitignore or .mamounignore excludes, or files that look like secrets.

Unsigned builds

The beta builds are not yet code-signed.

• macOS and Linux: installs through npm run normally.

• Windows with Smart App Control on (Windows 11): unsigned programs are blocked, and there is no "Run anyway"; mamoun says "Windows blocked …". Use WSL until the builds are signed. In an Ubuntu terminal:

  sudo apt update && sudo apt install -y npm
  sudo npm i -g @mamoun-code/cli
  mamoun login

  Your Windows folders are under /mnt/c/... there.

• Windows with SmartScreen: if it warns about mamoun.exe, choose More info, then Run anyway.

Update, log out, uninstall

npm i -g @mamoun-code/cli@latest   # update; Mamoun also tells you once a day when a newer version exists
mamoun logout            # log out on this machine
npm rm -g @mamoun-code/cli         # uninstall

You can also disconnect a machine from the web app: open the account menu at the foot of the sidebar and choose Connected CLIs.

Feedback

Send bugs and ideas to your beta contact. For a bug, include what you ran and what happened. If you can, also run it again with --debug and attach the log it names. The log holds ids and sizes, never file contents.