# Modus

> Open source coding agent workspace, an agent-first desktop app that runs locally. alternative to Cursor and Codex.

- **Type:** MCP server
- **Install:** `agentstack add mcp-brandlll-lee-modus`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [brandlll-lee](https://agentstack.voostack.com/s/brandlll-lee)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [brandlll-lee](https://github.com/brandlll-lee)
- **Source:** https://github.com/brandlll-lee/modus

## Install

```sh
agentstack add mcp-brandlll-lee-modus
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

English | 简体中文

  

Modus

  Local-first desktop workspace for AI coding agents.

  Getting started ·
  Features ·
  Security

## About

Modus is an open-source desktop app for running AI coding agents inside real local projects.

Open a workspace, connect your own model provider, plan or build, inspect changes, approve risky actions, and keep the full workflow in one window.

Modus is early and currently runs best from source.

## Features

- **Workspaces and sessions** - Open local projects, switch recent workspaces, pin projects, and keep separate agent sessions per repo.
- **Bring your own models** - Configure built-in or custom PI-compatible providers, defaults, reasoning effort, thinking variants, and model limits.
- **Git workflow** - Review working tree changes, file diffs, branches, commit history, commits, pushes, and session change stats.
- **Terminal, browser, and files** - Use a real PTY terminal, an in-app browser with tabs and DevTools, and a workspace file explorer.
- **Fast Codebase** - Let the agent build a compact local code map before reading files, reducing broad grep/read exploration.
- **Subagents** - Create specialized subagents, track their activity, and apply or clean up their worktrees.
- **Plan and build modes** - Start with a reviewable plan, answer structured questions, then move into implementation.
- **Context and images** - Attach files, folders, docs, Git diffs, terminal output, browser state, selected page elements, rules, and images.
- **MCP, skills, and rules** - Load Modus MCP servers, invoke local skills with `/`, and apply project rules from AGENTS/Claude/Cursor-style files.
- **Permissioned execution** - Route shell, Git, browser, MCP, file, and external actions through one approval flow.
- **Checkpoints and rollback** - Snapshot the workspace before agent runs and restore from the timeline when needed.

## Getting Started

Requirements for Windows and macOS:

- Node.js `>= 22.19.0`
- npm
- Rust + Cargo
- Git

```bash
git clone https://github.com/brandlll-lee/modus.git
cd modus
npm install
npm run dev
```

Then open a workspace folder and configure a model provider in Settings.

## Development

```bash
npm run dev
npm run check
npm run test
npm --workspace @modus/desktop run typecheck
npm --workspace @modus/desktop run build
```

Package locally:

```bash
npm --workspace @modus/desktop run package:win -- --publish never
npm --workspace @modus/desktop run package:mac -- --publish never
```

Run the Windows command on Windows and the macOS command on macOS.

## MCP Config

Modus only auto-loads its own MCP config files:

```text
~/.modus/mcp.json
/.modus/mcp.json
```

It does not silently import Cursor, Claude, Warp, or other agent configs.

## Tech Stack

Electron, React, TypeScript, Tailwind CSS, Base UI, Motion, Monaco, xterm.js, Streamdown, Node SQLite, Rust `portable-pty`, `@earendil-works/pi-coding-agent`, and the MCP SDK.

## Contributing

Contributions are welcome. Keep PRs small, use Conventional Commits, and run `npm run check` plus `npm run test` before opening a PR.

## License

Apache-2.0. See [LICENSE](./LICENSE).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [brandlll-lee](https://github.com/brandlll-lee)
- **Source:** [brandlll-lee/modus](https://github.com/brandlll-lee/modus)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-brandlll-lee-modus
- Seller: https://agentstack.voostack.com/s/brandlll-lee
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.