type Group = { id: string; name: string; tools: Tool[] };
const groups: Group[] = [
{
id: "files",
name: "Files",
tools: [
{
name: "read",
instead: "`cat`, `head`, `sed -n`",
text: "Several files in one call, with numbered lines. An image comes back as a picture.",
contrast: {
shell: "Sends the whole file, however long, and the model can't see an image.",
luxe: "A page at a time, stopping at a line boundary and saying where to pick up.",
},
},
{
name: "edit",
instead: "`sed -i`",
text: "Changes exact text, several edits in one call, all or none. It won't touch a file the agent hasn't read, or one that changed since.",
contrast: {
shell: "Exits 0 when the pattern matches nothing, so a missed edit looks like a done one.",
luxe: "Refuses a miss and points at the closest line, refuses an ambiguous match, and shows the diff after formatting.",
},
},
{
name: "write",
instead: "`cat > file`",
text: "Creates or replaces a whole file, and shows what it wrote.",
contrast: {
shell: "Replaces whatever was there, unseen.",
luxe: "Won't overwrite a file the agent hasn't read, keeps its line endings, and formats it.",
},
},
],
},
{
id: "search",
name: "Search",
tools: [
{
name: "glob",
instead: "`find`",
bench: "glob",
text: "Skips whatever `.gitignore` skips, so build output and dependencies stay out. Sorted by path, capped at 200, with a count of the rest.",
},
{
name: "grep",
instead: "`grep -rn`, `rg`",
bench: "grep",
text: "Capped per file and overall, with long lines trimmed. It can return just the files that match or just the counts, and says so when there's more.",
},
{
name: "ast_grep",
instead: "`grep` on code",
text: "Search and replace by code structure. A rewrite shows a preview before it writes.",
contrast: {
shell: "Matches text, so comments and strings count too.",
luxe: "Matches syntax: `$X.unwrap()` finds the calls and nothing else.",
},
},
],
},
{
id: "shell",
name: "Shell and tests",
tools: [
{
name: "bash",
instead: "`sh`",
bench: "bash",
text: "Long output comes back as the lines that matter, with every gap marked and the untouched text saved to a file, each stream whole up to 8 MB. A command that runs out of time returns what it printed so far.",
},
{
name: "test",
instead: "`cargo test`, `npm test`, `pytest`",
bench: "test",
text: "One line when everything passes. When something fails, each failure with its `file:line`, and which ones your change broke. Tests run the project's way, through its own `.venv` or package manager.",
},
],
},
{
id: "git",
name: "Git",
tools: [
{
name: "git",
instead: "`git`, `gh`",
bench: "git",
text: "The last ten commits, with a note when there are more. Diffs are capped and say how to narrow them. Pull requests, issues and CI checks come through `gh`.",
},
],
},
{
id: "code",
name: "Code intelligence",
tools: [
{
name: "read_symbol",
instead: "`cat`",
bench: "read_symbol",
text: "One function, struct or method by name, instead of the file it lives in.",
},
{
name: "module_report",
instead: "`cat`",
bench: "module_report",
text: "A file's outline: each symbol and the lines it spans, so the agent reads only what it needs.",
},
{
name: "symbol_search",
instead: "`rg 'fn name'`",
text: "Where something is defined, from its name or part of it.",
contrast: {
shell: "Matches text, and the pattern changes with every language.",
luxe: "Finds definitions by name in any language, ranked, with what kind of thing each one is.",
},
},
{
name: "impact",
instead: "nothing",
text: "What else a change touches, before the agent makes it.",
contrast: {
shell: "Callers of callers is a search per hop, and tests don't say what they cover.",
luxe: "Lists what calls a symbol, what depends on a file, and which tests cover it, a few hops out.",
},
},
{
name: "lsp_diagnostics",
instead: "`cargo check`, `tsc`",
text: "Errors and warnings for the files you name. They also come back on their own after every edit.",
contrast: {
shell: "Builds the whole project, one language at a time.",
luxe: "Asks the language server about one file, in any language that has a server.",
},
},
{
name: "lsp_navigation",
instead: "`grep` for a name",
text: "Definitions, references, types and renames, from the language server.",
contrast: {
shell: "Every line that spells the same name.",
luxe: "The definition and the real references, by meaning rather than spelling.",
},
},
],
},
{
id: "debug",
name: "Debugging",
tools: [
{
name: "debug",
instead: "print statements",
text: "Drives a real debugger, with breakpoints, stepping and variables, for Rust, C, C++, Python and Go.",
contrast: {
shell: "Add a print, rebuild, rerun, repeat.",
luxe: "Stops at a breakpoint and shows the frame and its locals, with library frames folded away.",
},
},
],
},
{
id: "web",
name: "The web",
tools: [
{
name: "web_fetch",
instead: "`curl`",
bench: "web_fetch",
text: "Pages come back as markdown, not HTML. A GitHub repository is cloned into the project, with its links flattened and no language server started in it, so the agent can search the real files.",
},
{
name: "web_search",
instead: "`curl` a search page",
text: "Searches the web through the provider you have a key for, or a free one.",
contrast: {
shell: "A page of HTML built for a browser.",
luxe: "Titles, links and the passage that matched.",
},
},
{
name: "screenshot",
instead: "`chrome --headless --screenshot`",
text: "Captures a page, so the agent can check the UI it just built.",
contrast: {
shell: "Writes a file the model never sees.",
luxe: "Returns the picture to the model, from your dev server or any page.",
},
},
],
},
];
const beyond = [
{ name: "todo", text: "A checklist that survives compaction, shown in the dock's PLAN." },
{ name: "question", text: "Stops to ask you, with choices, instead of guessing." },
{ name: "skill", text: "Loads a skill's instructions when the task calls for them." },
{ name: "mcp", text: "Your MCP servers behind one tool, every call checked against your permissions." },
];
// The primary repository draws the bars; a tool it has no case for (`web_fetch` is not about a
// repository) falls back to the next one that does