Sudo

Sudo is the admin-facing AI assistant of Curiosity Workspace: an in-product chat that reads, designs, changes and operates every configurable surface of your workspace. He works the way a developer works, by editing files and running commands, and nothing he writes reaches the workspace until you approve the diff.

He is not the assistant your end users talk to. That one searches the workspace and reads what it is handed. Sudo changes the workspace itself: endpoints, AI tools, agents, skills, prompt templates, scheduled tasks, indexes, schema, NLP, search settings, chat policies. The two wear different coats on purpose, so which one is in front of you is legible at a glance.

Despite the name, Sudo never assumes elevated privileges

He reads the graph as the administrator who is talking to him, under their permissions, and he asks first. Nothing is written until you turn on Allow changes and approve a specific diff.

How he works, in one paragraph

Your workspace configuration already round-trips through the definitions export as plain files: that is what the export zip, the WebDAV mount and the git tracking are. So the configuration is handed to Sudo as a filesystem, and he changes it the way anyone changes files. He reads them with cat and grep, edits them with sed or a heredoc, compiles them with build, and hands the result to you with commit. There is one tool, one sandbox, and one way into the workspace.

flowchart LR A[Your request<br/>in plain language] --> B[Read /workspace<br/>and /reference] B --> C[Edit the file] C --> D[build:<br/>parse + compile] D -->|fails| C D -->|passes| E[commit -m 'why'] E --> F{You review<br/>the diff} F -->|Approve| G[Applied as one<br/>tracked change] F -->|Discard| C

Where he appears

Surface What he is doing there
The admin chat pane The conversation itself. Collapsed by default, opened from a floating toggle carrying his avatar. Both only exist inside the admin interface, for system administrators.
The pending-changes panel The commit he has staged, if any, and the button that opens it for review.
The terminal window The same shell he is working in, opened from the chat toolbar, for when you would rather look yourself.
The composer, the transcript, the empty state His avatar, idling and fidgeting between turns.
The built-in editors He perches on the modal of a built-in AI tool, agent, skill or prompt template, which is how you tell a built-in from something your workspace authored.

The pane is aware of what you are looking at. The admin interface hands him a UI context block: the surface in the foreground tab is the active context, what "this endpoint" refers to when you say it, and everything open in adjacent tabs is background context used to disambiguate.

Two session modes

The empty chat asks how the session should work before anything else:

Just look, no touching

Read-only. He reads endpoints, AI tools, agents, schemas, tasks, settings and runtime state to answer questions, and drafts in his own copy of the configuration. commit refuses, and so does run. This is the default.

Let Sudo also suggest changes

The same session, plus the ability to hand you a commit and to run stored code. Nothing reaches the workspace until you approve a specific diff.

The Allow changes toggle (the pen icon in the chat toolbar) is the same switch and can be flipped mid-conversation. Turning it off does not take the shell away: taking the shell away would leave Sudo unable to read the workspace either. The toggle lands on the session and commit is what refuses, so an admin who forgot to turn it on does not lose the draft. Flip it on and the same commit works.

How he behaves

His voice and boundaries are a skill in your workspace (sudo-persona), so they are visible and editable rather than hard-wired:

  • Verify before acting. Intent, target resource, and likely impact, checked before anything is drafted.
  • Proceed on the small and reversible. Clearly requested, low-risk, reversible work goes ahead.
  • Ask first on the rest. Destructive, security-sensitive, externally visible, broad-impact or materially ambiguous requests stop and ask.
  • Smallest change that works. He edits the lines that need editing rather than retyping a file.
  • No invented state, no unconfirmed success. He does not claim a change worked without a result to show for it, and does not imply permissions he does not have.
  • Report what happened. What changed, where, whether it worked, what is left.

Competent first, charming second: he leads with the answer or the current status, and the cat shows up afterwards, if at all.

What he will not do

  • Write without approval. There is no path from a draft to your workspace that does not pass through a diff you approved, and the approval is bound to the exact commit you were shown.
  • Read your data. graph and query are read-only, run under the chatting admin's permissions and skip node types that are never returned to clients. Configuration, runtime state and files you staged are the whole of what he sees.
  • Reach the network. The sandbox has no route out: no curl, no wget, no HTTP from a command.
  • Manage users, teams or access-group membership. He can read access groups and reference one from a definition; membership is yours, under Manage / Access.
  • Read a secret value. He can declare a secret and write code that reads it. He can never see one.
  • Install packages, take backups, restart the workspace, or touch licensing.
  • Replace the admin pages. Everything he does is something you can do by hand, and every change he applies lands in the same tracked history as a manual one.

The sandbox

The in-process bash and Python he runs, the limits they run under, and what "sandboxed" buys you.

The workspace filesystem

Every mount, and how the folders under /workspace map onto the surfaces you configure by hand.

Commands

status, diff, build, commit, graph, query, run and the rest of what the sandbox adds.

Reviewing and approving

What a commit is, what the review screen shows, and exactly what approving does.

Skills

The recipes he reads before writing anything, and how to teach him your house conventions.

Security

The boundaries, who can reach him, what is audited, and what to watch.

© 2026 Curiosity. All rights reserved.