Documentation

TuxNest SI Agent

Understand execution modes, approvals, specialists, workflows and the evidence that separates a real action from a model claim.

Ask, Plan and Agent

• Ask is read-only repository understanding and Q&A.
• Plan inspects and produces a plan without executing code changes.
• Agent can propose edits, run approved commands and verify work.

Permissions

The default posture is to ask before edits or commands. Read-only inspection can be automatic for explicitly registered built-in tools, while protected or dangerous operations remain subject to stricter policy.

Read-only specialists

Agent mode can delegate approved read-only work to planner, repository analyst, reviewer or researcher roles. Workers inherit a bounded permission intersection, cannot recurse and cannot write or run commands.

Temporary workflow tools

A registered workflow can combine existing built-in operations into a fixed recipe for the current extension host. It does not evaluate generated JavaScript, replace built-ins or bypass approvals.

Completion is evidence, not tone

A process that started is not necessarily ready. A proposed edit is not necessarily saved. A confident model sentence is not a test result. Inspect the activity timeline, command result, review state and validation output.