Skip to main content
A motion is a natural-language proposal for action. This page covers the full motion lifecycle from the UI side — creation, editing, publishing, collaboration, and closing. For the concept itself — what a motion is and how it moves through the three phases — see How Monnet works.

Create a motion

Click New motion (or press m from anywhere) to open the create modal. Type a short prompt — one or two sentences describing the decision — and submit. Examples: The modal does a bit more than take a prompt:
  • Workspace selector — if you belong to more than one workspace, pick which one the motion lands in from the dropdown at the top. (With a single workspace it’s chosen for you.)
  • Attachments — add supporting files to seed the draft: drag and drop them onto the modal, paste an image from your clipboard, or click Attach files. Common document and image types are accepted (PDF, text, CSV, Markdown, JSON, HTML, and PNG/JPG/GIF/WebP/SVG).
  • Prompt length — up to 10,000 characters, so you can paste in real context, not just a one-liner.
Your unsent prompt is saved automatically as you type, so closing the modal or reloading won’t lose it — it’s there when you come back.
The New Motion modal showing a prompt, the workspace selector, and the attach-files paperclip

The New Motion modal: a prompt, a workspace selector, and an attach-files affordance.

Monnet drafts a structured motion from your prompt: a summary (one-liner), a body (the full document), and a plan (execution steps). You land on the motion detail page, where you can edit everything before publishing.

Edit a draft

While a motion is in Draft state, you can edit three things inline on the motion page:
  • Summary — the one-liner that appears in feeds and the inbox.
  • Body — the full proposal, edited in a rich-text (WYSIWYG) editor — not raw markdown. A toolbar gives you headings, bold and italic, bullet and numbered lists, links, and tables; select text and a formatting bubble menu appears inline. This is where context, rationale, and resolution live.
  • PriorityCritical / Normal / Low. Use the Priority dropdown in the right panel.
Every edit while the motion is Open creates a new version automatically (see Versions).

Publish a motion

When the body is ready, click Publish in the action banner. The motion moves from Draft to Open:
  • All motion members see the motion.
  • Monnet activates the plan and starts coordinating with assignees.
  • Notifications go out to people assigned to the first set of plan steps.
Before you publish, the motion is only visible to you and any editors you’ve added.

Add motion members

Open the Members area on the motion page and click Add member. You can:
  • Add a workspace member — pick from your team list.
  • Invite someone by email — they’ll receive a link to join the motion (as an External member if they’re not in the workspace).
Pick a role for each: Editor, Commenter, or External. See the roles table.

Work through the plan

The plan is a list of execution steps, visible in the Progress card on the right of the motion page. Each step has:
  • A description.
  • A status (Pending / In progress / Done).
  • Assignees — the humans or agents responsible.
  • Optionally, an approval requirement — the step needs explicit approval from assignees before it’s marked done.
If a step requires approval and you’re an assignee, you’ll see a banner on the motion: “This motion needs your review.” Click Approve to mark the step done from your side, or Reject to send it back. When all required assignees approve, the step completes and the plan advances.

Compare options and decide

When a decision comes down to a few settled alternatives — which vendor, which architecture, which path forward — Monnet lays them out as options: a side-by-side set of cards in the motion body, each with a short description and the trade-offs that matter. Options are how the team converges on a choice without scattering the discussion across comments. Each option card shows its title, a description, and Monnet’s analysis of the trade-offs. One card may be flagged as recommended.

Vote on an option

Anyone on the motion can react to each card with 👍 or 👎. Click a vote to cast it, click again to undo it. Counts update live as people vote, and hovering a count shows who voted. Voting is a lightweight signal of where the team leans — it doesn’t decide the motion on its own.

Mark an option as decided

When the team has converged, an editor clicks Mark as decided on the winning card. That card becomes the decision: it’s highlighted, the other options in the set are dimmed, and voting on them closes. The decision is recorded in the activity feed, and Monnet picks it up to carry the motion forward — typically by updating the plan to execute what you chose. Marking a different card later moves the decision; only one option in a set is decided at a time.
Options capture what you’re choosing between; the plan captures what happens once you’ve chosen. A motion can use either, both, or neither — Monnet adds options when a decision has clear alternatives worth comparing.
An options carousel on a motion with vote pills and a decided card

Options on a motion: side-by-side cards with vote pills and Mark as decided.

Discuss in the public feed

The Activity feed at the bottom of the motion page is the shared, public record for the motion. Comments and motion events — publishes, plan updates, version changes — appear together in one timeline, so the full history of the decision lives in a single place. Any editor or commenter can post; comments are visible to all motion members (including External members if any). The feed supports:
  • @mentions — type @ to mention a teammate or an agent. Mentions render as a chip and notify the person you tagged.
  • Threaded replies — reply under a specific comment to keep a side-discussion together. The reply box reads “Reply to thread…”, and replies nest beneath their parent.
  • Quote-to-comment — select any text in the motion body and a floating Comment button appears; click it to drop that text into the comment composer as a quote, so it’s clear what you’re responding to.
  • Emoji reactions — react to any comment or event with 👍, ✅ (Done), 🎉 (Celebrate), or pick another emoji from the reaction picker.
  • Edit your own comments — hover your comment and click Edit to revise it.
By default the feed shows Highlights — comments, decisions, approvals, and status changes. Switch the mode dropdown to All to also see every low-level action Monnet took (its individual tool steps). Use the feed to propose changes, flag concerns, or document decisions that shouldn’t live in the body.
A motion's Activity feed with a published-the-motion event, an @mention, and reactions

The Activity feed shows comments and motion events in one timeline, with @mentions and reactions.

Follow or mute a motion

Each motion has a bell toggle that controls whether you’re notified of its updates and comments. Click it to subscribe (get notified) or unsubscribe (stop getting notified) — useful for muting a busy motion you only want to check on occasionally, or keeping a close eye on one that matters. You’re subscribed to motions you’re involved in by default.

Work with Monnet in the chat

Open the Monnet Chat panel from the bottom-right of the motion page to work directly with the facilitator. Ask for research, request changes to the draft, talk through trade-offs, or have Monnet spin off a related motion. This chat is a working conversation, not a strictly private channel. The panel shows an unlock indicator with the note: “This chat isn’t private. Monnet may share what you write here with your team.” Monnet may surface relevant parts of the conversation to other members when it helps move the motion forward, so treat it as a back-channel with the facilitator rather than a confidential one. The chat is live and transparent:
  • Streaming replies — Monnet’s responses stream in token by token rather than appearing all at once.
  • Visible reasoning — you can see Monnet thinking before it answers.
  • Tool activity — when Monnet acts, the chat shows what it did: loading a skill, updating the motion summary and doc, updating the plan, setting priority, or creating a motion.
  • Create a motion from the chat — ask Monnet to spin off a related decision and it drafts a new motion from your conversation, then links to it.
A motion page with the Monnet Chat panel showing a streamed reply and the chat input

The Monnet Chat panel: a streaming, transparent conversation with the facilitator, with an unlock indicator showing it isn't strictly private.

Attach files

Use the Files section in the right panel to upload supporting documents (contracts, mockups, spreadsheets, screenshots). Files are scoped to the motion and visible to all motion members. Click the X next to a file to remove it.

View and restore previous versions

Every edit while the motion is Open creates a version. Open the Activity timeline on the right panel and click a version to see the diff against the current body. Click Restore to roll back to that version — this creates a new version rather than deleting history.

Change priority

In the right panel, use the Priority dropdown to switch between Critical, Normal, and Low at any time. The change is broadcast to all members and shown as a colored dot on the motion.

Close or reopen a motion

When the work is finished (or the motion is no longer worth pursuing), an editor can Close it. Closed motions are read-only. Any editor can Reopen a closed motion later — it moves back to Open and the plan resumes where it left off.