> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryinvesti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Approving changes

> The analyst never changes your workspace silently. Anything it wants to change arrives as a proposal you approve or reject.

The analyst can read anything in your workspace, but it can't change anything on its own. When it wants to update a thesis, append a finding, or restructure a checklist, it proposes the change and waits. Nothing is written until you approve it.

Right now, notes are the one thing that goes through this review step. As more of the workspace becomes editable, starting with [portfolios](/organize/portfolio-and-monitors) once they ship, the same rule holds: you see the exact change before it lands, every time.

## How a proposal works

<Steps>
  <Step title="The analyst proposes">
    During a conversation, an approval card appears in the chat describing the change. At the same time, the affected note gets a warning-colored dot in the explorer ("Change awaiting approval"), with dimmed dots on its parent folders so you can find it later.
  </Step>

  <Step title="You review the diff">
    Open the note to see a side-by-side diff of exactly what would change: your current text against the proposed text, with a review bar on top. When one proposal is part of a batch, the bar says so ("part of N changes").
  </Step>

  <Step title="Approve or decline">
    Select **Approve** to apply the change or **Decline** to reject it. You can act from the note's review bar or from the approval card in the chat; the two stay in sync. Approving creates a new revision in the note's [version history](/organize/notes#version-history), so even accepted changes can be rolled back later.
  </Step>
</Steps>

<Frame caption="An approval card in chat next to the note's side-by-side diff and review bar">
  <img src="https://mintcdn.com/investi-2b043b7b/-bImOKewi83djACr/images/analyst/approvals/approval-diff.jpeg?fit=max&auto=format&n=-bImOKewi83djACr&q=85&s=a88ea2b13c4458ccdbcaaf6e86a2d2ba" alt="Approval card in chat next to a side-by-side note diff and review bar" width="4683" height="2789" data-path="images/analyst/approvals/approval-diff.jpeg" />
</Frame>

## Why it works this way

Skills and conversations steer *how* the analyst works, but never *what* it may change on your behalf. The diff-and-approve flow guarantees that:

* You always see the exact change before it lands.
* Your workspace never drifts without your knowledge.
* Every applied change is one revision in history, reversible at any time.

<Note>
  Declining a proposal does not end the conversation. The analyst continues with your verdict in hand.
</Note>