Soumtok

Read a file from the current Studio workspace. Misspelled paths still resolve when the match is unique. For a long file, pass start_line/end_line to page through it instead of re-reading the whole thing.

Search workspace files for a pattern.

Find workspace paths matching a glob (e.g. **/*.tsx, src/**/*.ts).

List files and folders at a path relative to the workspace root.

Create or replace a file on disk. Required for new files. Chat XML, markdown fences, and <write> tags do not create files — you must call this tool.

Edit an existing workspace file. Pass old_string and new_string, or content for a full replacement. Do not call diff with only added/removed counts. New files must use write. Chat {"kind":"diff"} events do not change files.

Run a shell command in the workspace (Studio sandbox: node, python, npm test, git, etc.). On Soumtok Desktop IDE this runs on the user's real machine — see read_terminal in tool list for integrated Terminal.

Read captured output from Soumtok integrated Terminal on the user PC (ANSI stripped; includes URL/Ready summary). Use after terminal() starts dev servers; wait_ms 15000–25000 for Next.js. Do not read *-run.log or probe.txt instead.

Run lint or TypeScript check on paths (eslint/npm run lint or tsc --noEmit).

Launch a Soumtok subagent (like Cursor Task). subagent_type: explore (read-only codebase search) or generalPurpose (full tools). Returns a report for you to continue.

Clone the attached GitHub repository (or args.repo) into the workspace.

Fetch a public https page, SVG, or look up a query. For brand logos use https://cdn.simpleicons.org/{slug} or https://cdn.jsdelivr.net/npm/simple-icons/icons/{slug}.svg — keep the raw SVG markup.

Call a connected MCP server tool (GitHub, Figma, Neon, Slack, …). Results are saved under mcp-exports/ in the project. Connect services in the Connectors side bar (company logo → Connect).

Generate a still image with Flux 2 Max (no video, no music) and save it into the project. Use when they asked to generate/create/draw an image even if that is misspelled (genera, iamge, egale). Default path assets/generated/. Default aspect 1:1; pass aspect if they asked 16:9, 9:16, 4:3.

Look at an image or video already on disk (workspace path) or a data URL. Returns a detailed description the coding model can use. Does not generate video or music.

Remove ALL files and folders in the workspace root when the user asked to delete/clear the whole project. Keeps .git by default.

Ask the user clarifying questions with multiple-choice options. Execution pauses until they answer. Use when requirements are ambiguous.

Request switching agent mode (plan or agent). User may approve in UI.

Update structured todos shown in the agent UI (Cursor-style task list).

Git in the open folder: status (default), diff, log, branch, show, commit. Prefer this over terminal("git …"). commit only when the user asked to commit.

Search the repo by meaning (identifiers, paths, comments) — not only exact grep. Use on real codebases before scattering new files.

Open localhost or https, snapshot the page (visible text + screenshot + console + failed network), click or type. Use after npm run dev to SEE the UI — terminal logs are not a screenshot.

Load the full SKILL.md body for a named skill from the catalog (git-workflow, verify-ui, codebase-search, plugins-mcp, or project skills).

Call when the user request is actually done, with a short result. Requires tool evidence already in this turn (successful write/diff, tests, or localhost). A correct "nothing to change" also uses this instead of saying done in prose.