Skip to Content
MosaicMosaicDocs

Tasks

Track work with priorities, statuses, and linked context.

Starter documentation. Features and account details may differ from this deployment.

Mosaic Tasks start lightweight enough for a single user but scale easily onto a team, where tasks you create are auto-shared with members. They're @mentionable anywhere in Mosaic as live, up-to-date pills, sync bidirectionally with GitHub PRs to move status automatically, and are fully accessible to AI clients via Mosaic's MCP server.

Task Statuses

Tasks come with a small set of properties: Status, Priority, and Assignees. Add your own with Add property.

Not Started — the task hasn't been picked up yet
In Progress — someone is actively working on it
In Review — the work is done and awaiting review
Completed — the task is finished
Canceled — the task won't be done

You can reference a task in your channels, in your documents, or with an agent by @mentioning it. Quickly create a task directly from a channel or an email by hovering and selecting the task button.

You can manually review all of your team's tasks in the task view or ask your agent to give you updates on them.

Assigning agents

Each agent you assign to a task starts a session. The task's discussion gets a message that links to it, and the work stays in that session. People and agents can be assigned to the same task. Remove an agent and assign it again to start a new session.

Assign an agent to a project and it starts a session for each task added to that project afterward. Tasks already in the project are not started. Removing the agent stops that for tasks added later. Sessions already running keep going.

Team level sharing

When you're on a team, a new task is shared with its members unless you turn that off. The switch is labeled Share with and your team name, and it starts on. Turn it off and only you and the people you share it with can see the task. Teammates who can see it can view and comment, while you (and the assignee) keep full control over its status and properties. Assigning a task to someone sends them an inbox notification, as does @mentioning a teammate in the task's comments.

Sharing follows team membership

  • Join a team and you'll see the tasks shared with it, those assigned to you and to others.
  • If you're removed from the team, you lose access to them.
  • If you're not on a team, your tasks stay private to you.

GitHub integration

Mosaic tasks integrate with GitHub: as you create, review, and merge branches, the task automatically moves to "In Progress," "In Review," or "Completed," and the task records which pull request is associated with it. See GitHub integration for setup and details.

MCP setup

Mosaic's MCP server lets AI clients like Claude Code, Codex, and Cursor work with your tasks directly. Connect once by going to Settings → MCP server (authorize with your Mosaic account — MCP access is included on every plan, Free included). You can use the MCP server to spin up a task, triage your list, or move something to "In Review" without leaving your editor. Any changes made will show up live in Mosaic.

MCP for tasks uses

  • Create a task
  • Find your tasks
  • Read a task
  • Update a task

@mentioning

Tasks are markdown entities, so you can @mention one anywhere else in Mosaic — in a doc, an email, a chat, a channel, or another task. The mention renders as a live pill that stays in sync with the task's status and title, so wherever you reference it, you're always looking at the current state. Click it to jump straight to the task.

On this page