myman

# My Man

> My Man is an open-source (Apache-2.0) Mac app, with a Linux companion for agents, that gives people and their AI agents local screenshots, annotation, screen recording, meeting transcripts, dictation, notes, and searchable memory. Everything runs on-device and is saved as plain Markdown in `~/MyManBrain`. Agents such as Claude Code, Claude Desktop, Cursor, and Grok Bot use it through two local MCP servers (`myman-brain`, read-only search with citations; `myman-app`, over 120 permission-controlled app actions) or through the `myman` JSON CLI. All agent permissions start off and only the user can turn them on in Settings → Agents.

Key facts:
- Install: download the Mac app from https://muckstack.com/download/myman, open it once, and install Node.js 22+. Both MCP servers are then at `~/MyManBrain/tools/server.mjs` and `~/MyManBrain/tools/app-server.mjs`.
- Claude Code: `claude mcp add myman-brain -- node ~/MyManBrain/tools/server.mjs` and `claude mcp add myman-app -- node ~/MyManBrain/tools/app-server.mjs`.
- CLI: `/Applications/My Man.app/Contents/Resources/myman` (`myman doctor --json`, `myman actions`, `myman screenshot --mode agent --json`). Results are JSON; long work returns a job ID.
- Check permissions before acting with `myman doctor --json` or the `myman_app_capabilities` MCP tool. Agents cannot grant themselves permissions.
- No cloud relay, account, or API key. Requires macOS 14.2+ (screen recording needs macOS 15+).

## Linux and Omarchy

- What it is: a Node.js 22+ companion (version 0.13.0 in My Man 1.1.101) for Ubuntu/X11 and Omarchy/Hyprland (Sway also works): screenshots, markup, OCR, video-only screen recording, polished demos, meetings, Voxtype dictation, notes, tasks, Brain search, and the same `myman-app` MCP actions where supported. `myman actions` reports what is supported on Linux.
- Install from a release: download `myman-linux-x64.tar.gz` and `myman-linux-x64.tar.gz.sha256` from https://github.com/tommy-muckstack/myman/releases/latest, then run `sha256sum -c myman-linux-x64.tar.gz.sha256`, `tar -xzf myman-linux-x64.tar.gz`, and `bash myman-linux-x64/scripts/install-linux.sh`. The installer never runs sudo; it prints the optional apt or pacman packages (for example ImageMagick, grim on Wayland, tesseract for OCR, ffmpeg or wf-recorder for recording).
- CLI path: the installer puts the launcher at `~/.local/bin/myman` (programs in `~/.local/share/myman`; `MYMAN_INSTALL_PREFIX` changes `~/.local`). Add `~/.local/bin` to `PATH`. MCP servers: `node ~/.local/share/myman/app-server.mjs` (actions) and `node ~/.local/share/myman/server.mjs` (read-only Brain search). The Brain is `~/MyManBrain`.
- Arch/Omarchy package: `packaging/aur/` has a `myman-bin` PKGBUILD (installs to `/usr/lib/myman`, adds `/usr/bin/myman` and `/usr/bin/myman-setup`). It is not published on the AUR yet, so build it from that folder with `makepkg -si`, then run `myman-setup` once as each user. On Omarchy, `myman omarchy install` adds a SUPER+SHIFT+PRINT "show my agents" key and a MyMan menu.
- Owner grants: `~/.config/myman/agents.json` (or `$XDG_CONFIG_HOME/myman/agents.json`), created with every grant off: `{"version": 1, "grants": {"enabled": false, "capture": false, "markup": false, "recording": false, "library": false, "microphone": false, "control": false}}`. Only the owner edits this file; there is no CLI or MCP action that turns a grant on. An optional root-owned `/etc/myman/agents.json` caps them. Check with `myman doctor --json`.
- `myman demo` (one-command product demo, X11 only):
  1. Look: `myman demo --look --app gnome-calculator --json` returns a picture of the app window, a numbered copy with a 50-point grid, and each piece of on-screen text with its click point.
  2. Steps: write a steps file with `wait`, `move`, `click`, `type`, `key` and `scroll` steps. Clicks can name the text to click, for example `{"click": "Play", "caption": "Start the song"}` (`"nth": 2` picks the second match). A `caption` is a short line shown while that step plays.
  3. Dry run: `myman demo --script steps.json --dry-run --json` checks the file and prints the plan and estimated length without opening anything (needs only the `recording` grant).
  4. Run: `myman demo --script steps.json --json` opens the app, records only its window, runs the steps, then polishes the video with zoom, cursor, backdrop, music, and title and end cards. Needs the owner's `recording` and `control` grants.
- Wayland (Omarchy/Hyprland, Sway): screenshots and recording work (grim, wf-recorder), but `myman demo` and `demo --look` are not supported yet because they drive the app with xdotool. Record with `myman record start` and polish with `myman record polish` instead.

## Docs

- [README, agent section](https://github.com/tommy-muckstack/myman#for-ai-agents-claude-grok-bot-cursor): what agents can do and how to connect
- [CLI setup, commands, and JSON contract](https://github.com/tommy-muckstack/myman/blob/main/docs/agent-cli.md)
- [Mac and Linux capability matrix](https://github.com/tommy-muckstack/myman/blob/main/docs/agent-cli-parity.md)
- [Brain plugin: search, MCP tools, Grok Bot setup](https://github.com/tommy-muckstack/myman/blob/main/integrations/brain/README.md)
- [Agent skill](https://github.com/tommy-muckstack/myman/blob/main/skills/myman-brain/SKILL.md): retrieval and citation behavior for agents
- [Linux companion for agents](https://github.com/tommy-muckstack/myman/blob/main/docs/linux-agents.md): screenshots, recording, polished demos, MCP
- [Agent workflow recipes](https://github.com/tommy-muckstack/myman/blob/main/docs/agent-workflows.md)
- [Multi-agent workflows](https://github.com/tommy-muckstack/myman/blob/main/docs/multi-agent-workflows.md)

## Optional

- [Using My Man (people)](https://github.com/tommy-muckstack/myman/blob/main/docs/using-myman.md)
- [Contributing](https://github.com/tommy-muckstack/myman/blob/main/CONTRIBUTING.md) and [AGENTS.md](https://github.com/tommy-muckstack/myman/blob/main/AGENTS.md) for coding agents
- [Security policy](https://github.com/tommy-muckstack/myman/blob/main/SECURITY.md)