Skip to content

Mesa-App/mesa-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 

Repository files navigation

Mesa

Mesa

A spatial workspace for building with AI agents, terminals, and your entire dev stack — all on one canvas.

Website · Releases · Discord


Mesa replaces the mess of browser tabs, terminal windows, and scattered tools with a single zoomable canvas. Drop your projects onto it, attach the tools you need, and see everything at once — no more context switching.

How It Works

  1. Drag a folder onto the canvas to create a project node
  2. Attach tools — terminals, browser previews, editors, databases, notes, and more
  3. See everything — zoom and pan across all your projects and tools in one view
  4. Collaborate — invite teammates to your canvas in real-time

Each project node lives on an infinite canvas. You attach what you need to it — a terminal running Claude Code, a live browser preview of your dev server, a file editor, a database viewer — and arrange it all visually. Related projects can be connected with edges and organized into groups.

Features

Canvas

  • Infinite pan-and-zoom surface with snap grid
  • Drag-and-drop folders to create project nodes
  • Connect related projects with typed edges
  • Group nodes with custom colors
  • Minimap navigation for large workspaces
  • Command palette (Cmd+K) for quick access
  • Persistent layout — everything saves automatically

Attachments

Every project node supports multiple attachments that float, dock, or render inline:

Attachment Description
Terminal Real PTY shells — run bash, zsh, Claude Code, Codex, Gemini, or any CLI tool
Browser Live preview of your dev server with embedded WebView
File Editor Monaco Editor (the engine behind VS Code) with syntax highlighting, multi-cursor, and search
File Explorer Git-aware tree view with .gitignore filtering
Notes Markdown scratchpad for project context
HTTP Client REST and GraphQL request builder
Database Query and browse SQLite databases
Logs Tail process output and dev server logs
Port Watcher Monitor active network ports
DevTools Embedded Chrome DevTools
Figma View Figma designs alongside your code

AI Agent Support

Mesa treats AI coding agents as first-class citizens. Open a terminal attachment and run any agent — Claude Code, Codex, Gemini, Qwen, or anything else with a CLI. Watch agents work in real-time, side-by-side with browser previews showing the results.

Mesa also ships with an MCP server so that AI agents can control the workspace programmatically — creating nodes, managing attachments, and querying project state.

Git and GitHub

  • Branch status, file changes, staging, commits, push/pull — all built in
  • Git worktree support for parallel branches
  • GitHub PR tracking with CI status and review state
  • Dedicated PR nodes on the canvas with live check status
  • GitHub OAuth for seamless authentication

Multiplayer

Work on the same canvas with your team:

  • Presence cursors — see where teammates are looking
  • Terminal streaming — watch each other's terminal output live
  • Browser tunneling — view a teammate's localhost through the relay
  • Edit locks — prevent conflicting edits
  • Visibility controls — mark attachments as public, observable, or private

Plugins

Extend Mesa with custom attachment types. Drop a plugin into ~/.mesa/plugins/ and it hot-reloads into your workspace. Each plugin is a self-contained React component with access to the attachment API.

Installation

Download the latest release for your platform:

  • macOS.dmg
  • Windows.exe installer
  • Linux.AppImage

Mesa auto-updates when new versions are available.

Tech Stack

Layer Technology
Desktop shell Electron 40
UI React 19, React Flow 11
State Zustand 5
Editor Monaco Editor
Terminal xterm.js + node-pty
Database SQLite (local, WAL mode)
Multiplayer WebSocket relay
Build Vite, TypeScript

All workspace data is stored locally in SQLite. Nothing leaves your machine unless you opt into multiplayer.

Release Notes

See Releases for changelogs and downloads.

License

MIT

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors