Emm documentation
Emm is an issue tracker with a macOS desktop app and a standalone command-line tool for macOS and Linux. These guides use the workspace terminology introduced in the October 22, 2026 update. A workspace was called a project in earlier versions.
Vocabulary
- Workspace — the container for teams, issues, and shared work, stored in a folder containing
emm.db. - Team — a group of related issues inside a workspace.
- Issue — one item of work, identified by its number (for example 42 or #42).
- Notes — your Markdown files, opened and edited in Emm.
Basic work on your own computer needs no account. Sharing a workspace or Notes is a separate, explicit action.
Task guides
-
User profiles — assignments, retrospectives, discussions and trace inquiries.
-
Getting started — open Emm, create or open a workspace, and write your first issue.
- Issues — teams, priority, status, finding work, and who does what.
- Notes — opening, creating, editing, and linking Markdown files.
- Sharing — signing in, invitations, opening workspaces, and sharing Notes.
- Agents and CLI — command-line installation, help, and reading an issue from the terminal.
Get the app from the Emm download page and the CLI from the CLI download page.