Skip to content
NodespellNodespell Docs

Agent

Choose an Agent mode and approve actions

View as MarkdownAsk ChatGPTAsk Claude

Agent modes in Nodespell control what Agent may do to your graph during a request. Ask only answers. Plan proposes changes without making them. Edit makes the changes. In every mode, Agent still stops and asks before higher-impact actions, such as deleting nodes or starting a paid generation.

What does each Agent mode do?

Section titled “What does each Agent mode do?”

The mode menu sits next to the + button below the message box. Each option shows a short summary. Hover over an option to see its full description.

Mode Summary in the menu What Agent may do
Ask Answers only Answers questions about your project. Never changes it. Agent can read the graph, search catalogs and Assets, look at results, and estimate costs.
Plan Proposes first Reads your project and proposes changes. The graph does not change.
Edit Edits directly Makes graph edits during the request. Still asks before spending credits, and before the other actions listed below.

Edit is the default. Nodespell remembers the mode you choose in this browser. The mode applies to each message when you send it. A follow-up that you queue keeps the mode that was selected when you queued it. You can’t change the mode while Agent is working.

Change the mode before a request

Section titled “Change the mode before a request”

  1. Open the mode menu. It shows the current mode, for example Edit.

  2. Choose Ask, Plan, or Edit.

  3. Type your request and send it.

If Agent tries to change the graph in Ask or Plan, Nodespell refuses the change and Agent reports that it can’t make it. To carry out a plan, switch to Edit and ask Agent to apply the plan it proposed.

Which actions always need your approval?

Section titled “Which actions always need your approval?”

In Edit, Agent makes reversible graph edits on its own. The actions in the table below always pause for your decision, even in Edit.

Action Applies without asking in Edit Needs approval
Create, duplicate, or rename nodes Yes No
Change parameter values Yes No
Connect or disconnect nodes Yes No
Create a Creative Tool, or place Assets on the graph Yes No
Delete nodes No Yes
Switch a Creative Tool’s model No Yes
Prepare a run (a paid generation) No Yes
Start a prepared run No Yes
Cancel a run No Yes

Reading, searching, inspecting results, and estimating costs never change anything, so they never ask.

Approve or deny an action

Section titled “Approve or deny an action”

When Agent reaches one of these actions, the conversation shows a Needs your approval card that names the step. Agent waits until you decide.

  • Select Approve to let Agent continue with that exact step.
  • Select Deny to refuse the step. Agent continues without it, or explains what it couldn’t do.

After you decide, the card becomes a single line: Approved, Denied, or Expired. Each approval covers one action, based on the graph as it was when Agent asked. If the graph changes before that action runs, Nodespell rejects the action. Agent has to check the graph again and ask again. For generation approvals, see Generate with Agent.

Sometimes Agent needs more information instead of an approval. It then shows a Needs your input card with up to six choices. Select one of the choices, or type your own answer in the message box.

How do you undo what Agent changed?

Section titled “How do you undo what Agent changed?”

Each graph edit Agent makes goes into your normal undo history. Press Cmd/Ctrl+Z to step back through Agent’s changes, the same way you undo your own edits. Selecting Stop keeps any changes Agent already made. Undo them if you don’t want them.

Frequently asked questions

Section titled “Frequently asked questions”

What is the default Agent mode?

Section titled “What is the default Agent mode?”

Edit is the default. After you choose a different mode, Nodespell remembers it in the same browser.

Can Agent change my graph in Plan mode?

Section titled “Can Agent change my graph in Plan mode?”

No. In Plan, Agent reads the graph and describes the changes it would make. Switch to Edit and ask Agent to apply the plan.

Does Edit mode let Agent spend credits without asking?

Section titled “Does Edit mode let Agent spend credits without asking?”

No. In Edit, Agent asks for approval before it prepares a run and again before it starts the run. Agent’s own reasoning still uses credits for each request.

Why did my approval stop working?

Section titled “Why did my approval stop working?”

An approval covers one action, based on the graph as it was when Agent asked. If you or Agent change the graph first, Nodespell rejects that approval. Agent has to check the current graph and ask again.

Section titled “Related”