Shipeasy

Read vs write mode

Read tools auto-execute and stream a thinking trace; writes surface as editable cards you confirm before anything is applied.

BetaOn this page · 3 min readWorks with · In-dashboard chat

The assistant has two kinds of tools, and the difference between them is the entire safety model: reads happen automatically; writes are proposed first. You don't choose a mode — the assistant picks the right tool for what you asked. A write becomes an editable card, and the change runs only after you confirm it.

Read mode — answers, auto-executed

To answer a question, the assistant calls read-only tools. These run server-side, immediately, with no confirmation — they only ever look, never change. Each one streams to the chat as a thinking trace line that resolves with a check mark, so you can see exactly what it inspected.

read · auto
Which feature flags are at 100% but haven’t been touched in 90 days?
✓ Reading your project
✓ Checking flag status
✓ Searching the docs
Three flags are pinned at 100% and untouched for 90+ days — safe to retire:
  • legacy_checkout — fully rolled out, no rule references it
  • dark_mode — at 100% since March, rollout finished
  • beta_banner — superseded by nux_banner
Sources: Retiring flags · Flag lifecycle
Read tools run on their own and stream as a ✓ trace; the answer is grounded in your project and cites its docs. Nothing changes.

Prop

Type

Doc-grounded, not from memory

The assistant doesn't answer product questions from its training data. It calls search_docs first and grounds the answer in the returned sections, ending with a Sources: line of links — so every claim traces back to a doc page.

Write mode — proposals you confirm

To change something, the assistant emits the matching write tool with its best-guess arguments. The call surfaces as an editable confirmation card, and the underlying change runs only after you press Confirm. If a step can't be applied from the dashboard — it needs a code change, say — the assistant files it as a ticket instead, and says so.

That inversion is deliberate: because the change itself doesn't apply until you confirm, it's safe — and expected — for the assistant to propose a mutation directly rather than asking "should I?" first.

write · confirm
⚑Create feature flag
checkout_redesign
Whencountry in [US]
Rollout
10%
Defaultoff

Tweak the title and the highlighted controls here. To change anything else, ask in the chat and the assistant revises the plan.

ConfirmCancel
A write tool surfaces as an editable card — never auto-run. Rules show as chips and the rollout as a bar, exactly like the dashboard; it applies only on Confirm.

The write tools cover the full resource set:

release_flags_create / release_flags_update / release_flags_enable
release_flags_disable / release_flags_rollout / release_flags_archive
release_configs_create / release_configs_update / release_configs_draft
release_configs_publish / release_configs_archive
release_killswitch_create / release_killswitch_update
release_killswitch_set / release_killswitch_unset / release_killswitch_archive
metrics_create / metrics_archive
events_create / events_update / events_approve / events_archive
ops_create / ops_update / ops_notify
ops_alerts_create / ops_alerts_update / ops_alerts_archive

They are the same names the MCP server advertises — the assistant and an external coding agent drive one surface, not two.

Changes apply only when you confirm

The assistant hands you the card first; you apply it. If you cancel, the change isn't applied. One exception: when it drafts a metric, it may register the event that metric counts before you confirm, so that event can remain after a cancel. Deleting resources is also available directly in the dashboard UI.

Why the split holds

Reads are pure

Read tools only fetch — listing resources, reading docs, fetching a site page — so running them automatically can't surprise you. They're how the assistant grounds an answer.

Writes wait for your confirm

A write call doesn't apply on its own — it becomes a card on the client, with the assistant's best-guess arguments filled in for you to review, edit, and confirm.

You are the executor

The matching Server Action runs only after you confirm the card. Your session scopes everything to the project you're viewing.

There's a third kind of tool — presentation tools (ask_user, suggest_plan, select_slack_channel) — that also skip auto-execution but render as an interactive chooser or plan rather than a confirmation card. Those are covered next.

Was this page helpful?
Updated August 9, 2026✎ Edit this page

On this page