# Mason

> Mason is a native Mac app for people who build with coding agents. It analyzes your AI workflow while you work: where the day went, how you move between tools, and what you keep telling your agents. Open source, MIT.

## Use it

- [Get started](/docs/get-started.md): Mason is a native Mac app for people who build with coding agents. You install it and work. There is nothing to fill in and no account to make.
- [What you see](/docs/what-you-see.md): Mason has three surfaces: the island in the menu bar, the panel under it, and the app window.
- [What it reads, sends and keeps](/docs/privacy.md): Mason watches the work, not the screen. The memory is built on your Mac and stays there.
- [Models and voice](/docs/models-and-voice.md): Mason is not tied to one model. Watching, counting, the look back, Flow and Days are plain code and need none.
- [Agents and MCP](/docs/agents-and-mcp.md): Mason reads the logs your coding agents keep, and gives what it learned back to them.
- [Share and try workflows](/docs/workflows.md): A workflow is how someone works with coding agents, measured and not told: who they talk to, at what pace, how long an agent works on one thing, and what they tell their agents again and again.

## Look it up

- [Settings and configuration](/docs/configuration.md): Nothing here is needed to get started: every setting has a default that works. This page lists all of them.
- [When something is off](/docs/troubleshooting.md): The short list of what goes wrong, and what mends it. If yours is not here, open an issue.

## The project

- [How it is put together](/docs/how-it-is-built.md): Mason is a small native shell around a local server. The shell is Swift, the server is Node with no dependencies, and every screen is a web page the shell shows in its own windows.
- [Contributing](/docs/contributing.md): Mason is one person's tool that others are welcome to use, copy and improve. Two kinds of contribution are expected: a workflow for the collection, and a change to the code.
- [Security](/docs/security.md): Mason reads what you said to your coding agents and watches which app is in front. It is built so that this stays on your Mac and so that nobody else can steer it.
- [Code of conduct](/docs/code-of-conduct.md): This project follows the Contributor Covenant, version 2.1. The short form is below; the full text at that address is what holds.
- [What the films say, and where it is true](/docs/claims.md): Every claim in the technical walkthrough, with the code it rests on and the test that checks it. Run the tests with cd apprentice && npm test: the file is test/claims.test.mjs.