Tools

Nine moves.
None of them hidden.

This is the entire surface. headless can ask for one of these at a time, prints the ask and the result in order, and can reach nothing the root it started in cannot.

Reads · Writes · Shell · FinishSee how one move follows the last
  1. 01

    Look around

    list · reads

    List what is in a directory, and in the directories under it.

  2. 02

    Read a file

    read · reads

    Read a file and put its contents in front of the agent.

  3. 03

    Find files

    find · reads

    Find files by name pattern across the workspace.

  4. 04

    Search the code

    search · reads

    Search the contents of files for a word or a pattern.

  5. 05

    Write a file

    write · writes

    Create a file, or replace what is already in it.

  6. 06

    Make a folder

    mkdir · writes

    Create a directory, including any parents it needs.

  7. 07

    Delete a file

    remove · writes

    Delete a file from the workspace.

  8. 08

    Run a command

    run · shell

    Run a shell command. Closed until you open it for the run.

  9. 09

    Finish up

    done · finishes

    Close the task with a short summary of what changed.

That is the set. There is no plugin directory, no extension point and no hidden tool the catalogue does not list: what is on this page is what the loop can reach.

02 · Where it can go

Confined to your workspace.

Every tool above resolves its path against the root you started it in. Anything that lands outside is refused, not clamped, so the blast radius of a bad instruction is a directory you chose.

  • Every path resolves against the workspace root.

  • No absolute paths, and no climbing out with ..

  • node_modules, .git, dist and build are skipped when listing.

  • The exec tool is closed until you pass --shell.