A coding agent you stay in control of
MCA runs on your Mac with your own API key. It reads, edits and tests your code, shows every change, and asks before anything risky.
macOS · Apple Silicon and Intel · MIT licensed
Chats
sudo rm -rf ~This can cause damage that cannot be undone.
+ const list = await listSessions()
Everything in one workbench
Chat, project and tools side by side. Switch between one, two and three columns, or fold the sidebar with ⌘B and the tools with ⌘J.
Bring your own key
Use Anthropic or OpenRouter. Keys stay in your macOS Keychain, never in a project file.
Diff and revert
See what each turn changed, file by file. Undo one file, or the whole turn with Rewind.
Git built in
Stage, commit, push and create branches without leaving the app. Pushes are never forced.
Terminal tab
Run your own commands next to the chat, in your own login shell.
Images and @files
Paste or drop screenshots. Type @ to point the agent at any file in the project.
Your instructions
Extend or replace the system prompt. Add slash commands, skills and MCP servers.
Native notifications
A macOS notification when a task finishes or needs your approval, while you work elsewhere.
Chats per project
Resume, export to Markdown or delete the saved chats of every workspace.
Safe by default
The agent asks before it acts, and some things it never does without an explicit yes.
Permission modes
Default asks before edits and commands. Accept-edits allows file changes. Plan mode only reads. Bypass is opt-in.
Catastrophic commands
rm -rf ~, dd to a disk and friends always ask, in every mode, and are never remembered.
Untrusted projects
A project’s allow rules, hooks and MCP servers do nothing until you trust that workspace.
Up and running in a minute
Apple Silicon and Intel builds are available for macOS.
Builds are not signed or notarized yet. Only install builds from the official Releases page. The repository is currently private, so the Releases page and the source below need access to it (ask the maintainer); both become public once the repository is.
- Download the
.dmgfor your Mac from the project’s Releases page (arm64for M1 and later,x64for Intel). - Open it and drag mini-coding-agent into Applications.
- macOS blocks the first launch of unsigned apps. Run this once:
xattr -dr com.apple.quarantine "/Applications/mini-coding-agent.app" - Open the app, pick a provider, paste your API key and open a workspace.
Also in your terminal
The same agent, scriptable. mca works interactively and in pipelines.
mca -p "explain src/main" --permission-mode plan
git diff | mca -p "review this diff"
mca --continueInstall from source (Node 20.12 or newer, repository access required):
git clone https://github.com/yurtemre7/mini-coding-agent
cd mini-coding-agent && npm install && npm run build && npm link
mca --help