Grep the Octopus API catalog (llms.txt)
grep_llms_txtSearch the Octopus API catalog with grep-style semantics to efficiently find endpoints, sections, or steps without loading the full file.
Instructions
Search the Octopus API catalog at octopus://api/llms.txt with grep-style semantics. The catalog is large (~300+ KB) — call this rather than reading the resource body directly.
llms.txt is structured as:
Authentication and Space Selection sections (top of file)
Endpoints section: one '### {Category}' heading per resource family (Accounts, ActionTemplates, Channels, Releases, …) and one bullet per endpoint of the form
- \METHOD /path` - description | Prefixes (pick one): /{spaceId}, /spaces/{spaceIdentifier} | ?queryParams → ReturnType`Steps section: deployment step types (Octopus.* ActionType) and their configurable property keys.
Useful patterns:
'POST /releases' — find write endpoints under a resource family
'DELETE ' — enumerate delete endpoints
'### Channels' — jump to a section heading
'Body: Create.*Command' — find endpoints that take a Create command body
Parameter conventions mirror GNU grep:
pattern (regex by default; set fixedString:true for literal text)
caseInsensitive (-i)
invertMatch (-v)
fixedString (-F)
beforeContext (-B)
afterContext (-A)
maxCount (-m)
Response: totalMatches (true count across the whole file), totalLines, the matched lines with 1-indexed lineNumber, optional before/after context arrays, and catalogResourceUri for the structured fall-through.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pattern | Yes | Regex (default) or literal substring (when fixedString=true). Tested against each line of llms.txt independently — same model as `grep`. | |
| caseInsensitive | No | Equivalent to grep -i. Default false. | |
| invertMatch | No | Equivalent to grep -v: return lines that do NOT match. Default false. | |
| fixedString | No | Equivalent to grep -F: treat pattern as a literal substring, not a regex. Use this when grepping for text containing regex metacharacters. Default false. | |
| beforeContext | No | Equivalent to grep -B: lines of preceding context to include with each match. Capped at 50. | |
| afterContext | No | Equivalent to grep -A: lines of trailing context to include with each match. Capped at 50. | |
| maxCount | No | Equivalent to grep -m: stop returning matches after this many. totalMatches in the response still reflects the true count across the whole file. Hard cap 500. |