Skip to content
robotframework-mind

Ask the repo. Get a line.

Exact lookups over Robot Framework test repos: one file:line per hit, so people and agents stop reading whole suites.

Download the app

tests/cases.robot | ticket PROJ-2120

  1. $ python -m robot_mind --root . ticket PROJ-2120
  2. test Change Zone NEW Lists Zones
  3. tests/cases.robot:6
  4. [bug:PROJ-2120 role:role_team_lead op:GET /api/zones/list]

tests/cases.robot | callers "Open Cases Page"

  1. test Change Zone NEW Lists Zones tests/cases.robot:9
  2. test Cases Page Opens For QC tests/cases.robot:13
One file:line per hit. No suite dump.

Agents stop burning tokens on searching.

Characters read to answer one question on a real API test repo of 553 files. Shorter output is cheaper.

robotframework-mindgrep, then open the filescharacters of output, log scale

Tests for a ticket

12x
1,570
18,611

Where a keyword is defined

2073x
167
346,452

Who calls that keyword

102x
3,411
346,452

Tests with a tag

3.3x
41,107
136,226

Where an endpoint is used

918x
2,879
2,642,809

Method is in the README.

Two views. One engine.

Same index, for agents and for people.

Command line

CommandReturns
ticket KEYtests that cover it
kw NAMEwhere it is defined
callers NAMEevery call site
tag TAGtests with the tag
find TEXTendpoint, variable, value

Install and run

pip install robotframework-mind[gui]
python -m robot_mind_app

Windows, Mac and Linux builds: releases (unsigned, no budget for signing). On macOS: xattr -d com.apple.quarantine on the app, or build from source.

The app listing 18 tests tagged role:shopper across three repos, with kind, name, file and line, and tags
Table view: 18 tests tagged role:shopper across three repos, with kind, name, file and line.
The app showing a search for /api/orders as a graph of 31 nodes, coloured by repo
Graph view: a search for /api/orders as a graph of 31 nodes, coloured by repo.

What you need, and where it runs.

You need

  • Python 3.10 or newer
  • robotframework on PATH
  • A Robot Framework test repo

Works with

  • Any .robot or .resource file
  • JSON files under docs/
  • Windows, Linux and macOS

Learn more

Every command, flag and output shape is in the README, and the full list of changes is in the changelog.